函数
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 。 |