NAME

       osmium-time-filter - filter OSM data by time from a history file

SYNOPSIS

       osmium time-filter [OPTIONS] INPUT-FILE [TIME]
       osmium time-filter [OPTIONS] INPUT-FILE FROM-TIME TO-TIME

DESCRIPTION

       Copy  all  objects  that were valid at the given TIME or in the time period between FROM-TIME (inclusive)
       and TO-TIME (not inclusive) from the input file into the output file.  If no time is given,  the  current
       time is used.

       Usually  the  INPUT-FILE will be an OSM data file with history.  If both FROM-TIME and TO-TIME are given,
       the result will also have history data, it will also include deleted versions of objects.

       If only a single point in time was given, the result will be a normal OSM file without history containing
       no deleted objects.

       The format for the timestamps is "yyyy-mm-ddThh:mm::ssZ".

OPTIONS

       -f, --output-format=FORMAT
              The format of the output file.  Can be used  to  set  the  output  file  format  if  it  can't  be
              autodetected  from  the  output file name.  See osmium-file-formats(5) or the libosmium manual for
              details.

       -F, --input-format=FORMAT
              The format of the input file.  Can  be  used  to  set  the  input  file  format  if  it  can't  be
              autodetected from the file name.  See osmium-file-formats(5) or the libosmium manual for details.

       --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 "osmium/" and the version of osmium.

       -o, --output=FILE
              Name of the output file.  Default is '-' (stdout).

       --output-header=OPTION
              Add output header option.  This option can be given several times.  See the libosmium manual for a
              list of allowed header options.

       -O, --overwrite
              Allow  an  existing  output  file to be overwritten.  Normally osmium will refuse to write over an
              existing file.

       --fsync
              Call fsync after writing the output file to force the OS to flush buffers to disk.

       -v, --verbose
              Set verbose mode.  The program will output information about what it is doing to stderr.

DIAGNOSTICS

       osmium time-filter exits with exit code

       0      if everything went alright,

       1      if there was an error processing the data, or

       2      if there was a problem with the command line arguments.

EXAMPLES

       Extract current planet file from history planet:

              osmium time-filter -o planet.osm.pbf history-planet.osh.pbf

       Extract planet data how it appeared on January 1 2008 from history planet:

              osmium time-filter -o planet-20080101.osm.pbf history-planet.osh.pbf 2008-01-01T00:00:00Z

SEE ALSO

       • osmium(1), osmium-file-formats(5)

       • Osmium website (http://osmcode.org/osmium)

COPYRIGHT

       Copyright (C) 2013-2015 Jochen Topf <jochen@topf.org>.

       License GPLv3+: GNU GPL version 3 or later <http://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.

CONTACT

       If you have any questions or want to report a bug, please go to http://osmcode.org/contact.html

AUTHORS

       Jochen Topf <jochen@topf.org>.

                                                      1.3.0                                OSMIUM-TIME-FILTER(1)