与格林威治/ UTC的时区偏移,例如+02:00 。
时区偏移是时区与格林威治/ UTC不同的时间量。 这通常是固定的小时数和分钟数。
世界不同地区有不同的时区偏移。 ZoneId课程中记录了抵消方式因地点和时间而异的规则。
例如,巴黎冬季比格林威治/ UTC早一个小时,夏天早两小时。 该ZoneId实例巴黎将两个参考ZoneOffset实例-一个+01:00冬季实例和+02:00夏季实例。
2008年,世界各地的时区抵消时间从-12:00延长至+14:00。 为了防止该范围的任何问题被扩展,但仍提供验证,偏移范围限制在-18:00至18:00(含)。
此类设计用于ISO日历系统。 小时,分钟和秒的字段对这些字段的标准ISO定义有效。 此类可以与其他日历系统一起使用,前提是时间字段的定义与ISO日历系统的定义相匹配。
实现可以选择缓存某些常见的偏移,但是应用程序不能依赖于这种缓存。
在ZoneOffset实例上使用身份敏感操作(包括引用相等( == ),标识哈希码或同步)可能会产生不可预测的结果,应该避免使用。 应使用equals方法进行比较。
最大支持偏移量的常量。
最小支持偏移量的常量。
UTC的时区偏移量,ID为“Z”。
调整指定的时态对象以使其具有与此对象相同的偏移量。
将此偏移量按降序与另一个偏移量进行比较。
检查此偏移量是否等于另一个偏移量。
从时态对象获得
ZoneOffset的实例。
从此偏移量获取指定字段的值为
int 。
获取规范化区域偏移ID。
从此偏移量获取指定字段的值为
long 。
获取关联的时区规则。
获取以秒为单位的总区域偏移量。
此偏移的哈希码。
检查是否支持指定的字段。
使用ID获取
ZoneOffset的实例。
使用小时偏移量获得
ZoneOffset的实例。
使用小时和分钟的偏移量获得
ZoneOffset的实例。
使用小时,分钟和秒的偏移量获得
ZoneOffset的实例。
获得
ZoneOffset的实例,以秒为
ZoneOffset指定总偏移量
使用指定的查询查询此偏移量。
获取指定字段的有效值范围。
使用标准化ID将此偏移量输出为
String 。
UTC的时区偏移量,ID为“Z”。
最小支持偏移量的常量。
最大支持偏移量的常量。
使用ID获得ZoneOffset的实例。
此方法解析ZoneOffset的字符串ID以返回实例。 解析接受getId()生成的所有格式,以及一些其他格式:
Z - 适用于UTC
+h
+hh
+hh:mm
-hh:mm
+hhmm
-hhmm
+hh:mm:ss
-hh:mm:ss
+hhmmss
-hhmmss
请注意,±表示加号或减号。
返回的偏移的ID将标准化为getId()描述的格式之一 。
支持的最大范围为+18:00至-18:00(含)。
使用小时偏移量获得
ZoneOffset的实例。
使用小时和分钟的偏移量获得ZoneOffset的实例。
小时和分钟组件的符号必须匹配。 因此,如果小时为负,则分钟必须为负或零。 如果小时为零,则分钟可以是正数,负数或零。
使用小时,分钟和秒的偏移量获得ZoneOffset的实例。
小时,分钟和秒组件的符号必须匹配。 因此,如果小时为负,则分钟和秒必须为负或零。
从时态对象获得ZoneOffset的实例。
这基于指定的时间获得偏移。 TemporalAccessor表示一组任意日期和时间信息,该工厂将其转换为ZoneOffset的实例。
TemporalAccessor代表某种形式的日期和时间信息。 此工厂将任意时间对象转换为ZoneOffset的实例。
此方法匹配功能接口TemporalQuery的签名,允许通过方法引用ZoneOffset::from将其用作查询。
获得ZoneOffset的实例,以秒为ZoneOffset指定总偏移量
偏移量必须在-18:00到+18:00范围内,对应于-64800到+64800。
获取以秒为单位的总区域偏移量。
这是访问偏移量的主要方式。 它将小时,分钟和秒字段的总和作为可添加到时间的单个偏移量返回。
获取规范化区域偏移ID。
ID是偏移的标准ISO-8601格式字符串的微小变化。 有三种格式:
Z - for UTC(ISO-8601)
+hh:mm或-hh:mm - 如果秒数为零(ISO-8601)
+hh:mm:ss或-hh:mm:ss - 如果秒数不为零(不是ISO-8601)
获取关联的时区规则。
查询时,规则将始终返回此偏移量。 实现类是不可变的,线程安全的和可序列化的。
检查是否支持指定的字段。
这将检查是否可以为指定字段查询此偏移量。 如果为false,则调用range和get方法将引发异常。
如果该字段是ChronoField,则在此处实现查询。 OFFSET_SECONDS字段返回true。 所有其他ChronoField实例将返回false。
如果该字段不是ChronoField ,则通过调用TemporalField.isSupportedBy(TemporalAccessor)传递this作为参数来获得此方法的结果。 字段是否受支持由字段确定。
获取指定字段的有效值范围。
范围对象表示字段的最小和最大有效值。 此偏移用于增强返回范围的准确性。 如果无法返回范围,因为不支持该字段或由于某些其他原因,将引发异常。
如果该字段是ChronoField,则在此处实现查询。 所有其他ChronoField实例将抛出UnsupportedTemporalTypeException 。
如果该字段不是ChronoField ,则通过调用TemporalField.rangeRefinedBy(TemporalAccessor)传递this作为参数来获得此方法的结果。 是否可以获得范围由该字段确定。
从此偏移量获取指定字段的值,如int 。
这将查询此偏移量以获取指定字段的值。 返回的值将始终在该字段的有效值范围内。 如果无法返回该值,因为不支持该字段或由于某些其他原因,将引发异常。
如果该字段是ChronoField,则在此处执行查询。 OFFSET_SECONDS字段返回偏移量的值。 所有其他ChronoField实例将抛出UnsupportedTemporalTypeException 。
如果该字段是不是一个ChronoField ,则此方法的结果是通过调用获得TemporalField.getFrom(TemporalAccessor)传递this作为参数。 是否可以获得该值以及该值表示的值由该字段确定。
从此偏移量获取指定字段的值为long 。
这将查询此偏移量以获取指定字段的值。 如果无法返回该值,因为不支持该字段或由于某些其他原因,将引发异常。
如果该字段是ChronoField,则在此处执行查询。 OFFSET_SECONDS字段返回偏移量的值。 所有其他ChronoField实例将抛出UnsupportedTemporalTypeException 。
如果该字段是不是一个ChronoField ,则此方法的结果是通过调用获得TemporalField.getFrom(TemporalAccessor)传递this作为参数。 是否可以获得该值以及该值表示的值由该字段确定。
使用指定的查询查询此偏移量。
这将使用指定的查询策略对象查询此偏移量。 TemporalQuery对象定义用于获取结果的逻辑。 阅读查询文档以了解此方法的结果。
调整指定的时态对象以使其具有与此对象相同的偏移量。
这将返回与输入相同的可观察类型的时间对象,其中偏移量已更改为与此相同。
// these two lines are equivalent, but the second approach is recommended
temporal = thisOffset.adjustInto(temporal);
temporal = temporal.with(thisOffset);
此实例是不可变的,不受此方法调用的影响。
将此偏移量按降序与另一个偏移量进行比较。
偏移量按它们在世界各地的同一时间发生的顺序进行比较。 因此,偏移量为+10:00之前的偏移量为+09:00 ,依此类推至-18:00 。
比较是“与equals一致”,如Comparable所定义。
检查此偏移量是否等于另一个偏移量。
比较基于以秒为单位的偏移量。 这相当于ID的比较。
此偏移的哈希码。
使用标准化ID将此偏移量输出为
String 。
字段
变量和类型
字段
描述
最大支持偏移量的常量。
最小支持偏移量的常量。
UTC的时区偏移量,ID为“Z”。变量和类型
方法
描述
调整指定的时态对象以使其具有与此对象相同的偏移量。
int
将此偏移量按降序与另一个偏移量进行比较。
boolean
检查此偏移量是否等于另一个偏移量。
从时态对象获得
ZoneOffset的实例。
int
从此偏移量获取指定字段的值为
int 。
获取规范化区域偏移ID。
long
从此偏移量获取指定字段的值为
long 。
int
获取以秒为单位的总区域偏移量。
int
此偏移的哈希码。
boolean
检查是否支持指定的字段。
String offsetId)
使用ID获取
ZoneOffset的实例。
使用小时偏移量获得
ZoneOffset的实例。
使用小时和分钟的偏移量获得
ZoneOffset的实例。
使用小时,分钟和秒的偏移量获得
ZoneOffset的实例。
获得
ZoneOffset的实例,以秒为
ZoneOffset指定总偏移量
R
使用指定的查询查询此偏移量。
使用标准化ID将此偏移量输出为
String 。