GRASS GIS 7 Programmer's Manual  7.9.dev(2021)-e5379bbd7
incr1.c File Reference
#include <grass/datetime.h>
Include dependency graph for incr1.c:

Go to the source code of this file.

Functions

int datetime_increment (DateTime *src, DateTime *incr)
 This function changes the 'src' date/time data based on the 'incr' The type (mode/from/to) of the 'src' can be anything. The mode of the 'incr' must be RELATIVE, and the type (mode/from/to) for 'incr' must be a valid increment for 'src'. See datetime_is_valid_increment(), datetime_check_increment() Returns: 0: OK -1: 'incr' is invalid increment for 'src' For src.mode ABSOLUTE,. More...
 

Function Documentation

◆ datetime_increment()

int datetime_increment ( DateTime src,
DateTime incr 
)

This function changes the 'src' date/time data based on the 'incr' The type (mode/from/to) of the 'src' can be anything. The mode of the 'incr' must be RELATIVE, and the type (mode/from/to) for 'incr' must be a valid increment for 'src'. See datetime_is_valid_increment(), datetime_check_increment() Returns: 0: OK -1: 'incr' is invalid increment for 'src' For src.mode ABSOLUTE,.

  • positive 'incr' moves into the future,
  • negative 'incr' moves into the past.
  • BC implies the year is negative, but all else is positive. Also, year==0 is illegal: adding 1 year to 1[bc] gives 1[ad]

The 'fracsec' in 'src' is preserved. The 'from/to' of the 'src' is preserved. A timezone in 'src' is allowed - it's presence is ignored. NOTE: There is no datetime_decrement() To decrement, set the 'incr' negative.

Parameters
src
incr
Returns
int

Definition at line 67 of file incr1.c.

Referenced by datetime_change_timezone().