函数

GLibDateTimenew

自:2.26

声明 [源]

GDateTime*
g_date_time_new (
  GTimeZone* tz,
  gint year,
  gint month,
  gint day,
  gint hour,
  gint minute,
  gdouble seconds
)

描述 [源]

创建一个新的与指定时区和日期时间对应的GDateTime

year必须在1到9999之间,month必须在1到12之间,而day则根据月份和年份在1到28,29,30或31之间。

hour必须在0到23之间,而minute必须在0到59之间。

seconds必须至少是0.0,且必须严格小于60.0。它将被向下舍入到最接近的微秒。

如果给定的时间在给定时区中不可表示(例如,2010年3月14日在多伦多的02:30,由于夏令时),则时间将被四舍五入到最接近的现有时间(在这种情况下为03:00)。如果这对您很重要,那么您应该验证返回值是否包含与您提供的相同数字。

如果在给定时区中给定的时间是模糊的(例如,2010年11月7日在多伦多的01:30,由于夏令时),则取标准时间(即:非夏令时)。

此函数的值超出范围不被认为是编程错误,但如果确实如此,则函数将返回NULL

您应该通过调用g_date_time_unref()来释放返回值。

自可用:2.26

参数

tz

类型: GTimeZone

一个GTimeZone

数据由函数的调用者拥有。
year

类型: gint

日期的年份部分。

month

类型: gint

日期的月份部分。

day

类型: gint

日期的日部分。

hour

类型: gint

日期的小时部分。

minute

类型: gint

日期的分钟部分。

seconds

类型: gdouble

分钟过去后的秒数。

返回值

类型: GDateTime

一个新的GDateTime,或NULL

函数的调用者将拥有数据,并且负责释放它。
返回值可以是NULL