.TH "OSMIUM-TIME-FILTER" "1" "1.5.1" "" ""
.SH NAME
.PP
osmium\-time\-filter \- filter OSM data by time from a history file
.SH SYNOPSIS
.PP
\f[B]osmium time\-filter\f[] [\f[I]OPTIONS\f[]]
\f[I]OSM\-HISTORY\-FILE\f[] [\f[I]TIME\f[]]
.PD 0
.P
.PD
\f[B]osmium time\-filter\f[] [\f[I]OPTIONS\f[]]
\f[I]OSM\-HISTORY\-FILE\f[] \f[I]FROM\-TIME\f[] \f[I]TO\-TIME\f[]
.SH DESCRIPTION
.PP
Copy all objects that were valid at the given \f[I]TIME\f[] or in the
time period between \f[I]FROM\-TIME\f[] (inclusive) and
\f[I]TO\-TIME\f[] (not inclusive) from the input file into the output
file.
If no time is given, the current time is used.
.PP
Usually the \f[I]INPUT\-FILE\f[] will be an OSM data file with history.
If both \f[I]FROM\-TIME\f[] and \f[I]TO\-TIME\f[] are given, the result
will also have history data, it will also include deleted versions of
objects.
.PP
If only a single point in time was given, the result will be a normal
OSM file without history containing no deleted objects.
.PP
The format for the timestamps is "yyyy\-mm\-ddThh:mm::ssZ".
.SH COMMON OPTIONS
.TP
.B \-h, \-\-help
Show usage help.
.RS
.RE
.TP
.B \-v, \-\-verbose
Set verbose mode.
The program will output information about what it is doing to
\f[I]stderr\f[].
.RS
.RE
.SH INPUT OPTIONS
.TP
.B \-F, \-\-input\-format=FORMAT
The format of the input file(s).
Can be used to set the input format if it can\[aq]t be autodetected from
the file name(s).
This will set the format for all input files, there is no way to set the
format for some input files only.
See \f[B]osmium\-file\-formats\f[](5) or the libosmium manual for
details.
.RS
.RE
.SH OUTPUT OPTIONS
.TP
.B \-f, \-\-output\-format=FORMAT
The format of the output file.
Can be used to set the output file format if it can\[aq]t be
autodetected from the output file name.
See \f[B]osmium\-file\-formats\f[](5) or the libosmium manual for
details.
.RS
.RE
.TP
.B \-\-fsync
Call fsync after writing the output file to force flushing buffers to
disk.
.RS
.RE
.TP
.B \-\-generator=NAME
The name and version of the program generating the output file.
It will be added to the header of the output file.
Default is "\f[I]osmium/\f[]" and the version of osmium.
.RS
.RE
.TP
.B \-o, \-\-output=FILE
Name of the output file.
Default is \[aq]\-\[aq] (STDOUT).
.RS
.RE
.TP
.B \-O, \-\-overwrite
Allow an existing output file to be overwritten.
Normally \f[B]osmium\f[] will refuse to write over an existing file.
.RS
.RE
.TP
.B \-\-output\-header=OPTION
Add output header option.
This option can be given several times.
See the \f[I]libosmium manual\f[] for a list of allowed header options.
.RS
.RE
.SH DIAGNOSTICS
.PP
\f[B]osmium time\-filter\f[] exits with exit code
.TP
.B 0
if everything went alright,
.RS
.RE
.TP
.B 1
if there was an error processing the data, or
.RS
.RE
.TP
.B 2
if there was a problem with the command line arguments.
.RS
.RE
.SH MEMORY USAGE
.PP
\f[B]osmium time\-filter\f[] does all its work on the fly and
doesn\[aq]t keep much data in main memory.
.SH EXAMPLES
.PP
Extract current planet file from history planet:
.IP
.nf
\f[C]
osmium\ time\-filter\ \-o\ planet.osm.pbf\ history\-planet.osh.pbf
\f[]
.fi
.PP
Extract planet data how it appeared on January 1 2008 from history
planet:
.IP
.nf
\f[C]
osmium\ time\-filter\ \-o\ planet\-20080101.osm.pbf\ history\-planet.osh.pbf\ 2008\-01\-01T00:00:00Z
\f[]
.fi
.SH SEE ALSO
.IP \[bu] 2
\f[B]osmium\f[](1), \f[B]osmium\-file\-formats\f[](5)
.IP \[bu] 2
Osmium website (http://osmcode.org/osmium-tool/)
.SH COPYRIGHT
.PP
Copyright (C) 2013\-2017 Jochen Topf <jochen@topf.org>.

License GPLv3+: GNU GPL version 3 or later
<https://gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.SH CONTACT
.PP
If you have any questions or want to report a bug, please go to
http://osmcode.org/contact.html
.SH AUTHORS
Jochen Topf <jochen@topf.org>.