G_USEC_PER_SEC

#define G_USEC_PER_SEC 1000000

Количество микросекунд в одной секунде (1 миллион). Этот макрос обеспечивает удобочитаемость кода.

GTimeVal

typedef struct {
  glong tv_sec;
  glong tv_usec;
} GTimeVal;

Представляет точное время, с секундами и микросекундами. Похоже на возврат struct timeval вызова the gettimeofday() UNIX.

g_get_current_time ()

void        g_get_current_time              (GTimeVal *result);

Аналог UNIX функции gettimeofday(), но переносимый.

g_usleep ()

void        g_usleep                        (gulong microseconds);

Приостанавливает текущий поток на определённое количество микросекунд. В секунде есть 1 миллион микросекунд (представляется с помощью макроса G_USEC_PER_SEC). g_usleep() может иметь ограниченную точность, зависит от аппаратуры и операционной системы; не полагайтесь на точную длину паузы.

g_time_val_add ()

void        g_time_val_add                  (GTimeVal *time_,
                                             glong microseconds);

Добавляет полученное количество микросекунд к time_. microseconds может быть также отрицательным для уменьшения значения time_.

g_time_val_from_iso8601 ()

gboolean    g_time_val_from_iso8601         (const gchar *iso_date,
                                             GTimeVal *time_);

Конвертирует строку содержащую код даты и времени ISO 8601 в GTimeVal и помещает её в time_.

Начиная с версии 2.12

g_time_val_to_iso8601 ()

gchar*      g_time_val_to_iso8601           (GTimeVal *time_);

Конвертирует time_ в строку кода ISO 8601, относительно Coordinated Universal Time (UTC).

Начиная с версии 2.12

GDate

typedef struct {
  guint julian_days : 32; /* julian days representation - we use a
                           *  bitfield hoping that 64 bit platforms
                           *  will pack this whole struct in one big
                           *  int
                           */

  guint julian : 1;    /* julian is valid */
  guint dmy    : 1;    /* dmy is valid */

  /* DMY representation */
  guint day    : 6;
  guint month  : 4;
  guint year   : 16;
} GDate;

Представляет день между 1 Января 1 Года и и несколькими тысячами лет будущего. Ни к одному из членов не нужно обращаться непосредственно. Если GDate определена из g_date_new(), она будет безопасна для изменений, но недоступна и поэтому не безопасна для календарных расчётов. Если это объявить в стеке, он будет содержать мусор поэтому должен быть инициализирован с помощью g_date_clear(). g_date_clear() делает дату недопустимой но нормальной. Недопустимая дата не представляет день, она "пустая". Дата становится допустимой после того, как вы установите её в Юлианский день или день, месяц и год.

GTime

typedef gint32  GTime;

Просто замена для time_t. Она устарела так как не является эквивалентом для time_t на 64-битных платформах с 64-битной time_t. Несвязана с GTimer.

Помните что GTime определяется всегда как 32bit целочисленное, в отличие от time_t которая может быть 64bit на некоторых системах. Поэтому, GTime переполнится в 2038 году, и вы не сможете использовать адрес переменной GTime как аргумент для UNIX функции time(). Вместо этого сделайте следующее:

time_t ttime;
GTime gtime;

time (&ttime);
gtime = (GTime)ttime;

enum GDateDMY

typedef enum
{
  G_DATE_DAY   = 0,
  G_DATE_MONTH = 1,
  G_DATE_YEAR  = 2
} GDateDMY;

Это перечисление не используется в API, но может быть полезно если вам необходимо маркировать номер как день, месяц, или год.

GDateDay

typedef guint8  GDateDay;   /* day of the month */

Целочисленное представляющее день в месяце; между 1 и 31. G_DATE_BAD_DAY представляет недопустимый день в месяце.

enum GDateMonth

typedef enum
{
  G_DATE_BAD_MONTH = 0,
  G_DATE_JANUARY   = 1,
  G_DATE_FEBRUARY  = 2,
  G_DATE_MARCH     = 3,
  G_DATE_APRIL     = 4,
  G_DATE_MAY       = 5,
  G_DATE_JUNE      = 6,
  G_DATE_JULY      = 7,
  G_DATE_AUGUST    = 8,
  G_DATE_SEPTEMBER = 9,
  G_DATE_OCTOBER   = 10,
  G_DATE_NOVEMBER  = 11,
  G_DATE_DECEMBER  = 12
} GDateMonth;

Перечисление представляющее месяц; значениями являются G_DATE_JANUARY, G_DATE_FEBRUARY, и т.д.. G_DATE_BAD_MONTH представляет недопустимое значение.

GDateYear

typedef guint16 GDateYear;

Целочисленное представляющее год; G_DATE_BAD_YEAR представляет недопустимое значение. Год должен быть 1 или больше; отрицательное значение недопустимо. Год представляется четырьмя цифрами.

enum GDateWeekday

typedef enum
{
  G_DATE_BAD_WEEKDAY  = 0,
  G_DATE_MONDAY       = 1,
  G_DATE_TUESDAY      = 2,
  G_DATE_WEDNESDAY    = 3,
  G_DATE_THURSDAY     = 4,
  G_DATE_FRIDAY       = 5,
  G_DATE_SATURDAY     = 6,
  G_DATE_SUNDAY       = 7
} GDateWeekday;

Перечисление представляющее день в неделе; G_DATE_MONDAY, G_DATE_TUESDAY, и т.д.. G_DATE_BAD_WEEKDAY недопустимый день недели.

G_DATE_BAD_DAY

#define G_DATE_BAD_DAY    0U

Представляет недопустимую GDateDay.

G_DATE_BAD_JULIAN

#define G_DATE_BAD_JULIAN 0U

Представляет недопустимый номер дня в Юлианском представлении.

G_DATE_BAD_YEAR

#define G_DATE_BAD_YEAR   0U

Представляет недопустимый год.

g_date_new ()

GDate*      g_date_new                      (void);

Распределяет GDate и инициализирует её до нормального сотсояния. Новая дата будет очищена (как если бы вы вызвали g_date_clear()) но недопустима (она не будет представлять существующий день). Возвращаемое значение освобождается с помощью g_date_free().

g_date_new_dmy ()

GDate*      g_date_new_dmy                  (GDateDay day,
                                             GDateMonth month,
                                             GDateYear year);

Аналогична g_date_new(), но также устанавливает значение даты. Допустим вы помещаете в тройку день-месяц-год существующий день, тогда возвращаемая дата будет допустимой.

g_date_new_julian ()

GDate*      g_date_new_julian               (guint32 julian_day);

Аналогична g_date_new(), но так же устанавливает значение даты. Допустим вы поместили допустимый Юлианский номер дня (больше чем 0, меньше чем разумно большое число), возвращаемая дата будет допустимой.

g_date_clear ()

void        g_date_clear                    (GDate *date,
                                             guint n_dates);

Инициализирует одну или больше структур GDate до нормального, но недопустимого состояния. Очищенные даты не будут представлять существующие даты, но не будут содержать мусор. Полезно для инициализации дат объявленных в стеке. Допустимость может быть проверена с помощью g_date_valid().

g_date_free ()

void        g_date_free                     (GDate *date);

Освобождает GDate возвращаемую из g_date_new().

g_date_set_day ()

void        g_date_set_day                  (GDate *date,
                                             GDateDay day);

Устанавливает день месяца для GDate. Если результат тройки день-месяц-год недопустим, дата будет недопустимой.

g_date_set_month ()

void        g_date_set_month                (GDate *date,
                                             GDateMonth month);

Устанавливает месяц в году для GDate. Если результат тройки день-месяц-год недопустим, дата будет недопустимой.

g_date_set_year ()

void        g_date_set_year                 (GDate *date,
                                             GDateYear year);

Устанавливает год для GDate. Если результат тройки день-месяц-год недопустим, дата будет недопустимой.

g_date_set_dmy ()

void        g_date_set_dmy                  (GDate *date,
                                             GDateDay day,
                                             GDateMonth month,
                                             GDateYear y);

Устанавливает значение GDate из дня, месяца и года. Тройка день-месяц-год должна быть допустимой; если вы не уверены в этом, вызовите g_date_valid_dmy() для проверки перед установкой.

g_date_set_julian ()

void        g_date_set_julian               (GDate *date,
                                             guint32 julian_date);

Устанавливает значение GDate от Юлианского номера дня.

g_date_set_time ()

void        g_date_set_time                 (GDate *date,
                                             GTime time_);

Устанавливает значение даты из значения GTime.

Устаревшее:2.10: Вместо неё используйте g_date_set_time_t().

g_date_set_time_t ()

void        g_date_set_time_t               (GDate *date,
                                             time_t timet);

Устанавливает значение даты из значения time_t.

Для установки значения даты текущего дня, вы должны написать:

 
 g_date_set_time_t (date, time (NULL)); 

Начиная с версии 2.10

g_date_set_time_val ()

void        g_date_set_time_val             (GDate *date,
                                             GTimeVal *timeval);

Устанавливает значение даты из значения GTimeVal. Помните что tv_usec член игнорируется, потомучто GDate не может использовать дополнительную точность.

Начиная с версии 2.10

g_date_set_parse ()

void        g_date_set_parse                (GDate *date,
                                             const gchar *str);

Анализирует строку пользовательского ввода str, и пытается выяснить какую дату она представляет, принимая во внимание текущую локаль. Если строка полностью проанализирована, дата будет доступна после вызова. Иначе, она будет недоступна. С помощью g_date_valid() вы должны проверить выполнен ли анализ строки успешно.

Эта функция не является соответствующей для форматированных файлов и т.п.; она не очень точна и точность её поведения изменяется в зависимости от локали. Она предназначена для эвристической подпрограммы которая предполагает что пользователь подразумевает данной строкой (в этом смысле она работает вполне прилично).

g_date_add_days ()

void        g_date_add_days                 (GDate *date,
                                             guint n_days);

Увеличивает дату некоторым количеством дней. Для перемещения понедельно, добавьте weeks*7 days. Дата должна быть допустимой.

g_date_subtract_days ()

void        g_date_subtract_days            (GDate *date,
                                             guint n_days);

Перемещение даты на некоторое количество дней в прошлое. Для понедельного перемещения, просто используйте weeks*7 days. Дата должна быть допустимой.

g_date_add_months ()

void        g_date_add_months               (GDate *date,
                                             guint n_months);

Увеличивает дату на некоторое количество месяцев. Если день месяца больше чем 28, эта подпрограмма может изменить день месяца (потомучто месяц назначения может не иметь такого текущего дня). Дата должна быть допустимой.

g_date_subtract_months ()

void        g_date_subtract_months          (GDate *date,
                                             guint n_months);

Перемещает дату на некоторое количество месяцев в прошлое. Если текущий день месяца не существует в месяце назначения, день месяца может быть изменён. Дата должна быть допустимой.

g_date_add_years ()

void        g_date_add_years                (GDate *date,
                                             guint n_years);

Увеличивает дату некоторым количеством лет. Если датой является 29 Февраля, а год назначения не является високосным, дата будет изменена на 28 Февраля. Дата должна быть допустимой.

g_date_subtract_years ()

void        g_date_subtract_years           (GDate *date,
                                             guint n_years);

Перемещает дату на некоторое число лет в прощлое. Если текущий день не существует в году назначения (то есть это 29 Февраля и вы перемещаетесь не в високосный год) то день изменяется на 28 Февраля. Дата должна быть допустимой.

g_date_days_between ()

gint        g_date_days_between             (const GDate *date1,
                                             const GDate *date2);

Расчитывает число дней между двумя датами. Если date2 находится перед date1, возвращается негативное значение. Обе даты должны быть допустимыми.

g_date_compare ()

gint        g_date_compare                  (const GDate *lhs,
                                             const GDate *rhs);

qsort()-style функции для сравнения дат. Обе даты должны быть допустимыми.

g_date_clamp ()

void        g_date_clamp                    (GDate *date,
                                             const GDate *min_date,
                                             const GDate *max_date);

Если date находится перед min_date, устанавливает date как эквивалент min_date. Если date расположена после max_date, устанавливает date как эквивалент max_date. Любой параметр min_date и max_date может быть NULL. Все не-NULL даты должны быть допустимыми.

g_date_order ()

void        g_date_order                    (GDate *date1,
                                             GDate *date2);

Проверяет меньше ли date1 или эквивалентна date2, и сбрасывает значение если это не так.

g_date_get_day ()

GDateDay    g_date_get_day                  (const GDate *date);

Возвращает день месяца. Дата должна быть допустимой.

g_date_get_month ()

GDateMonth  g_date_get_month                (const GDate *date);

Возвращает месяц в году. Дата должна быть допустимой.

g_date_get_year ()

GDateYear   g_date_get_year                 (const GDate *date);

Возвращает год из GDate. Дата должна быть допустимой.

g_date_get_julian ()

guint32     g_date_get_julian               (const GDate *date);

Возвращает Юлианский день или "серийный номер" из GDate. Юлианский день - это просто номер дня начиная с 1 Января 1 Года; то есть, 1 Января 1 Года является 1 Юлианским днём; 2 Января 2 Года является 2 Юлианским днём, и т.д.. Дата должна быть допустимой.

g_date_get_weekday ()

GDateWeekday g_date_get_weekday             (const GDate *date);

Возвращает день недели для GDate. Дата должна быть допустимой.

g_date_get_day_of_year ()

guint       g_date_get_day_of_year          (const GDate *date);

Возвращаемый день в году, где 1 Января является первым днём года. Дата должна быть допустимой.

g_date_get_days_in_month ()

guint8      g_date_get_days_in_month        (GDateMonth month,
                                             GDateYear year);

Возвращает число дней в месяце, принимая во внимание високосные годы.

g_date_is_first_of_month ()

gboolean    g_date_is_first_of_month        (const GDate *date);

Возвращает TRUE если дата является первым днём месяца. Дата должна быть допустимой.

g_date_is_last_of_month ()

gboolean    g_date_is_last_of_month         (const GDate *date);

Возвращает TRUE если дата является последним днём месяца. Дата должна быть допустимой.

g_date_is_leap_year ()

gboolean    g_date_is_leap_year             (GDateYear year);

Возвращает TRUE если год является високосным.

g_date_get_monday_week_of_year ()

guint       g_date_get_monday_week_of_year  (const GDate *date);

Возвращает неделю в году, где недели начинаются с понедельника. Если дата перед первым понедельником в году, возвращается 0. Дата должна быть допустимой.

g_date_get_monday_weeks_in_year ()

guint8      g_date_get_monday_weeks_in_year (GDateYear year);

Возвращает количество недель в году, где недели начинаются с понедельника. Будет либо 52 либо 53. Дата должна быть допустимой. (Года всегда имеют 52 периода по 7-дней, плюс 1 или 2 дополнительных дня в зависимости от того, является ли год високосным. Эта функция в основном сообщает сколько понедельников находится в году, то есть 53 понедельника будет если один из дополнительных дней окажется понедельником.)

g_date_get_sunday_week_of_year ()

guint       g_date_get_sunday_week_of_year  (const GDate *date);

Возвращает неделю года на которую выпадает дата, если недели начинаются с воскресенья. Дата должна быть допустимой. Может вернуть 0 если день находится перед первым воскресеньем в году.

g_date_get_sunday_weeks_in_year ()

guint8      g_date_get_sunday_weeks_in_year (GDateYear year);

Возвращает количество недель в году, где недели начинаются с воскресенья. Будет либо 52 либо 53. Дата должна быть допустимой. (Годы всегда имеют 52 периода по 7-дней, плюс 1 или 2 дополнительных дня в зависимости от того, является ли год високосным. Эта функция в основном сообщает вам сколько воскресений в году, то есть является ли 53 воскресенье дополнительным днём года.)

g_date_get_iso8601_week_of_year ()

guint       g_date_get_iso8601_week_of_year (const GDate *date);

Возвращает неделю года, где недели интерпретируются согласно ISO 8601.

Начиная с версии 2.6

g_date_strftime ()

gsize       g_date_strftime                 (gchar *s,
                                             gsize slen,
                                             const gchar *format,
                                             const GDate *date);

Генерирует печатное представление даты, локале-зависимым способом. Работает просто как платформенная C библиотечная функция strftime(), но принимает только дата-зависимые форматы; время-зависимые форматы выдают неопределённый результат. Дата должна быть допустимой. В отличие от strftime() (которая использует локальную кодировку), эта функция работает со строками в кодировке UTF-8 и сохраняет результат в кодировке UTF-8.

Эта функция не обеспечивает никаких дополнительных спецификаторов конвертирования для платформенной реализации библиотеки C. Например, не ждите что использование g_date_strftime() сделает F обеспечив C99 strftime() работая на Windows где библиотека C скомпилирована только для C89.

g_date_to_struct_tm ()

void        g_date_to_struct_tm             (const GDate *date,
                                             struct tm *tm);

Заполняет дата-зависимый бит в struct tm используя значение date. Инициализирует non-date пары с чем то нормальным но бессмысленным.

g_date_valid ()

gboolean    g_date_valid                    (const GDate *date);

Возвращает TRUE если GDate представляет существующий день. Дата не должна содержать мусор; она должна быть инициализирована с помощью g_date_clear() если она не была распределена одним из вариантов g_date_new().

g_date_valid_day ()

gboolean    g_date_valid_day                (GDateDay day);

Возвращает TRUE если день месяца допустим (день допустим если он находится в промежутке чисел от 1 до 31 включительно).

g_date_valid_month ()

gboolean    g_date_valid_month              (GDateMonth month);

Возвращает TRUE если значение месяца допустимо. Только 12 значений в перечислении GDateMonth являются допустимыми.

g_date_valid_year ()

gboolean    g_date_valid_year               (GDateYear year);

Возвращает TRUE если год допустим. Допустимым является год только больше 0, однако есть 16-битный предел того что может понять GDate.

g_date_valid_dmy ()

gboolean    g_date_valid_dmy                (GDateDay day,
                                             GDateMonth month,
                                             GDateYear year);

Возвращает TRUE если форма триплёта день-месяц-год допустима, существует понятный день в диапазоне дней GDate (1 год или больше, но не больше нескольких тысяч лет в будущее).

g_date_valid_julian ()

gboolean    g_date_valid_julian             (guint32 julian_date);

Возвращает TRUE ели Юлианский день допустим. Число больше нуля в основном является допустимым Юлианским днём, однако есть 32-битный предел.

g_date_valid_weekday ()

gboolean    g_date_valid_weekday            (GDateWeekday weekday);

Возвращает TRUE если день недели допустим. Только 7 значений в перечислении GDateWeekday являются допустимыми.