time_add_month_with_zone


Description:

[ CCode ( cname = "time_add_month_with_zone" ) ]
public long time_add_month_with_zone (long time, int months, Timezone zone)

Adds or subtracts a number of months to/from the given time_t value, using the given timezone.

If the day would be off the end of the month (e.g. adding 1 month to 30th January, would lead to an invalid day, 30th February), it moves it down to the last day in the month, e.g. 28th Feb (or 29th in a leap year.)

NOTE: this function is only here to make the transition to the timezone functions easier. New code should use ICalTime values and adjust to add or subtract days, hours, minutes & seconds.

Parameters:

time

A time_t value.

months

Number of months to add.

zone

Timezone to use.

Returns:

a time_t value containing time plus the months added.


Namespace: ECal
Package: libecal-2.0