Time

---

Object Hierarchy:

Description:

Content:

Static methods:

• public static int days_in_month (int month, int year)
  Gets the number of days in the target month in the target year.
• public static int days_in_year (int year)
  Returns the number of days in this year.
• public static bool days_is_leap_year (int year)
  Checks whether a year is a leap year.
• public static void timezone_expand_vtimezone (Component comp, int end_year, Array changes)
  Applies a list of timezone changes on the array of components until the end year.

Creation methods:

• public Time ()
  Creates a new Time.
• public Time.current_with_zone (Timezone? zone)
  Creates a Time according to the timezone and current time.
• public Time.from_day_of_year (int day, int year)
  Creates a new time, given a day of year and a year.
• public Time.from_string (string str)
  Creates a time from an ISO format string.
• public Time.from_timet_with_zone (long v, int is_date, Timezone? zone)
  Converts seconds past UNIX epoch to a timetype, using timezones.
• public Time.null_date ()
  Creates a null date, which indicates no time has been set.
• public Time.null_time ()
  Creates a default time which is an epoch time.
• public Time.today ()
  Creates a Time representing today.

Methods:

• public Time add (Duration d)
  Adds a time duration on the time.
• public void adjust (int days, int hours, int minutes, int seconds)
  Adds or subtracts a number of days, hours, minutes and seconds from this.
• public string as_ical_string ()
  Returns a string representation of the time, in RFC2445 format.
• public long as_timet ()
  Returns the time as seconds past the UNIX epoch.
• public long as_timet_with_zone (Timezone? zone)
  Returns the time as seconds past the UNIX epoch, using timezones.
• public Time clone ()
  Creates a new Time, copy of this.
• public int compare (Time b)
  i_cal_time_compare returns an integer indicating the result of the comparison, as follow:
• public int compare_date_only (Time b)
  Like compare , but only use the date parts.
• public int compare_date_only_tz (Time b, Timezone? zone)
  Like i_cal_time_compare_tz, but only use the date parts; accepts timezone.
• public void convert_timezone (Timezone? from_zone, Timezone? to_zone)
  Convert time from one timezone to another.
• public Time convert_to_zone (Timezone? zone)
  Converts this to zone and return new Time object.
• public void convert_to_zone_inplace (Timezone? zone)
  Converts this to zone and store the result into this.
• public int day_of_week ()
  Returns the day of the week of the given time.
• public int day_of_year ()
  Returns the day of the year of the given time.
• public void get_date (out int year, out int month, out int day)
  Gets the year/month/date parts of the this in one call.
• public int get_day ()
  Gets the day of Time.
• public int get_hour ()
  Gets the hour of Time.
• public int get_minute ()
  Gets the minute of Time.
• public int get_month ()
  Gets the month of Time.
• public int get_second ()
  Gets the second of Time.
• public void get_time (out int hour, out int minute, out int second)
  Gets the hour/minute/second parts of the this in one call.
• public unowned Timezone get_timezone ()
  Returns the timezone, the Timezone object is cached and can be either unreferenced once the last instance is used or can be kept until free_global_objects is called (usually at the very end of the program).
• public unowned string? get_tzid ()
  Returns the tzid, or NULL for a floating time.
• public int get_year ()
  Gets the year of Time.
• public bool is_date ()
  Returns true if time is of DATE type, false if DATE-TIME.
• public bool is_daylight ()
  Gets the is_daylight of Time.
• public bool is_null_time ()
  Returns true if the time is null.
• public bool is_utc ()
  Returns true if time is relative to UTC zone.
• public bool is_valid_time ()
  Returns true if the time is null.
• public Time normalize ()
  Normalizes the icaltime, so that all fields are within the normal range.
• public void normalize_inplace ()
  Normalizes the this, so that all fields are within the normal range.
• public void set_date (int year, int month, int day)
  Sets the year/month/date parts of the this in one call.
• public void set_day (int day)
  Sets the day of Time.
• public void set_hour (int hour)
  Sets the hour of Time.
• public void set_is_date (bool is_date)
  Sets the is_date of Time.
• public void set_is_daylight (bool is_daylight)
  Sets the is_daylight of Time.
• public void set_minute (int minute)
  Sets the minute of Time.
• public void set_month (int month)
  Sets the month of Time.
• public void set_second (int second)
  Sets the second of Time.
• public void set_time (int hour, int minute, int second)
  Sets the hour/minute/second parts of the this in one call.
• public void set_timezone (Timezone? zone)
  Sets the timezone of the this.
• public void set_year (int year)
  Sets the year of Time.
• public int start_doy_week (int fdow)
  Returns the day of the year for the first day of the week that the given time is within.
• public Duration subtract (Time t2)
  Gets the duration between two time.
• public int week_number ()
  Returns the week number for the week the given time is within.

Inherited Members: