tzoffset

相对于 UTC 的时区偏移量

全页折叠

语法

dt = tzoffset(t)
[dt,dst] = tzoffset(t)

说明

dt = tzoffset(t) 返回一个持续时间数组，其中每个持续时间等于 t 中的每个日期时间值相对于 UTC 的时区偏移量。也就是说，dt 是 t 中的每个日期时间与 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 = 1×3 datetime
   31-Aug-2025   30-Nov-2025   28-Feb-2026

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

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


dst = 1×3 duration
   01:00   00:00   00:00

输入参数

全部折叠

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

输出参量

全部折叠

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

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

扩展功能

全部展开

版本历史记录

在 R2014b 中推出

另请参阅