Main Content

tzoffset

相对于 UTC 的时区偏移量

说明

示例

dt = tzoffset(t) 返回一个持续时间数组,其中每个持续时间等于 t 中的每个日期时间值相对于 UTC 的时区偏移量。也就是说,dtt 中的每个日期时间与 UTC 之间相差的时间量。对于发生在夏令时 (DST) 期间的日期时间,dt 包含 DST 时间偏移。未设置时区的日期时间值的偏移量未定义。

示例

[dt,dst] = tzoffset(t) 还额外返回 t 中每个日期时间的夏令时时间偏移。

示例

全部折叠

以纽约市对应的时区创建一个 datetime 数组。

t1 = datetime('today','TimeZone','America/New_York');
t = dateshift(t1,'end','month',[1:3:9])
t = 1x3 datetime
   30-Sep-2023   31-Dec-2023   31-Mar-2024

求出每个日期时间值与 UTC 的时区偏移量及其夏令时时间偏移。

[dt,dst] = tzoffset(t)
dt = 1x3 duration
   -04:00   -05:00   -04:00

dst = 1x3 duration
   01:00   00:00   01:00

输入参数

全部折叠

日期时间输入,指定为 datetime 数组。

输出参数

全部折叠

相对于 UTC 的时区偏移量,以标量、向量、矩阵或多维 duration 数组形式返回。dt 的大小与 t 相同。

夏令时的时差,以标量、向量、矩阵或多维 duration 数组形式返回。dt 的大小与 t 相同。值 01:00 指示 t 中的对应日期时间发生在夏令时期间观测它的位置。对于不遵守夏令时的位置,dst 数组的元素均为 00:00

扩展功能

版本历史记录

在 R2014b 中推出

另请参阅