SimpleTimeZone 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
SimpleTimeZone 是一个具体子类 TimeZone ,表示用于公历的时区。
[Android.Runtime.Register("java/util/SimpleTimeZone", DoNotGenerateAcw=true)]
public class SimpleTimeZone : Java.Util.TimeZone
[<Android.Runtime.Register("java/util/SimpleTimeZone", DoNotGenerateAcw=true)>]
type SimpleTimeZone = class
inherit TimeZone
- 继承
- 属性
注解
SimpleTimeZone 是一个具体子类 TimeZone ,表示用于公历的时区。 该类保留 GMT 的偏移量,称为 <em>原始偏移<量/em>,以及夏令时计划的开始和结束规则。 由于它只保存每个值的单个值,因此它不能处理与 GMT 和夏令时计划相差的历史变化,但 #setStartYear setStartYear 该方法可以指定夏令时计划生效时的年份。
若要构造SimpleTimeZone夏令时计划,可以使用一组规则、<em>start-rule/em> 和 <em>end-rule<</em> 来描述计划。 夏令时开始或结束的一天由 em>month/em、<em-of-month<></em> 和 <em>day-of-week</em>> 值的组合<指定。 em month/em> 值由日历Calendar#MONTH MONTH字段值表示,例如Calendar#MARCH。<><
<em>day-of-week</em> 值由日历Calendar#DAY_OF_WEEK DAY_OF_WEEK值表示,例如Calendar#SUNDAY SUNDAY。 值组合的含义如下所示。
<ul>li b Exact day of month</b><br> To specify an exact day of month, set the <em>month</em> and em day-of-month</em> to an exact value, and <<em>>day-of-week</em> to zero.>><< 例如,若要指定 3 月 1 日,请将 <em month/em> 设置为 Calendar#MARCH MARCH,<em>day-of-month<</em> 设置为 1,em <>day-of-week</em> 设置为 0。<>/li>
<li><b>week on or after day of month</b><br> To specify a day of week on or after an exact day of month, set the <em>month</em> to an exact month value, <em>day-of-month</em> to the day on or after the day the rule is applied, <em>day-of-week</em> to a negative Calendar#DAY_OF_WEEK DAY_OF_WEEK field value. 例如,若要指定 4 月的第二个星期日,请将 <em>month/em> 设置为 Calendar#APRIL APRIL,<em>day-of-month<</em> 设置为 8,em <>day-of week</em> 设置为Calendar#SUNDAY SUNDAY 。<-/li>
<li><b>week on or before day of month</b><br> To specify a day of the week on or before an exact day of the month/em, set <em>day-of-month</em> and <em>day-of-week</em> to a negative value. 例如,若要在 3 月 21 日或之前指定最后一个星期三,请将 <em month/em 设置为 Calendar#MARCH MARCH,<em>day-of-month<</em>> 为 -21,em <>day-of-week</em> 为 。-Calendar#WEDNESDAY WEDNESDAY>
</li>
<li><b>月<的最后一周/b><br> 要指定,月份的最后一周日期,将 <em>day-of-week</em> 设置为值 Calendar#DAY_OF_WEEK DAY_OF_WEEK , <em>day-of-month</em> 设置为 -1。 例如,若要指定 10 月的最后一个星期日,请将 em month/em> 设置为 Calendar#OCTOBER OCTOBER,<em day-of-week</em> to Calendar#SUNDAY SUNDAY and <em>>day-of-month</em> 设置为 -1。<><
</li>
</ul> 夏令时开始或结束的一天的时间,指定一天中的毫秒值。 有三种类型的 em mode/em>s 用于指定时间:#WALL_TIME和 #STANDARD_TIME#UTC_TIME。<>< 例如,如果夏令时以凌晨 2:00 结束,则可以在 #WALL_TIME 模式中指定 7200000 毫秒。 在这种情况下,em>结束规则</em> 的<时钟时间与夏令时相同。
下面是用于构造时区对象的参数示例。
<code>
// Base GMT offset: -8:00
// DST starts: at 2:00am in standard time
// on the first Sunday in April
// DST ends: at 2:00am in daylight time
// on the last Sunday in October
// Save: 1 hour
SimpleTimeZone(-28800000,
"America/Los_Angeles",
Calendar.APRIL, 1, -Calendar.SUNDAY,
7200000,
Calendar.OCTOBER, -1, Calendar.SUNDAY,
7200000,
3600000)
// Base GMT offset: +1:00
// DST starts: at 1:00am in UTC time
// on the last Sunday in March
// DST ends: at 1:00am in UTC time
// on the last Sunday in October
// Save: 1 hour
SimpleTimeZone(3600000,
"Europe/Paris",
Calendar.MARCH, -1, Calendar.SUNDAY,
3600000, SimpleTimeZone.UTC_TIME,
Calendar.OCTOBER, -1, Calendar.SUNDAY,
3600000, SimpleTimeZone.UTC_TIME,
3600000)
</code>
这些参数规则也适用于设置规则方法,例如 setStartRule。
在 1.1 中添加。
Java文档java.util.SimpleTimeZone。
本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。
构造函数
| 名称 | 说明 |
|---|---|
| SimpleTimeZone(Int32, String, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32) |
构造一个 SimpleTimeZone,其给定的基本时区偏移量与 GMT、时区 ID 以及开始和结束夏令时的规则。 |
| SimpleTimeZone(Int32, String, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32) |
构造一个 SimpleTimeZone,其给定的基本时区偏移量与 GMT、时区 ID 以及开始和结束夏令时的规则。 |
| SimpleTimeZone(Int32, String, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32) |
构造一个 SimpleTimeZone,其给定的基本时区偏移量与 GMT、时区 ID 以及开始和结束夏令时的规则。 |
| SimpleTimeZone(Int32, String) |
构造一个 SimpleTimeZone,其给定的基本时区偏移量与 GMT 和时区 ID 没有夏令时计划。 |
| SimpleTimeZone(IntPtr, JniHandleOwnership) |
创建 JNI 对象的托管表示形式时使用的构造函数;由运行时调用。 |
字段
| 名称 | 说明 |
|---|---|
| Long |
已过时.
用于 |
| Short |
已过时.
用于 |
| StandardTime |
已过时.
指定为标准时间的开始或结束时间模式的常量。 |
| UtcTime |
已过时.
指定为 UTC 的开始或结束时间模式的常量。 |
| WallTime |
已过时.
指定为时钟时间的开始或结束时间模式的常量。 |
属性
| 名称 | 说明 |
|---|---|
| Class |
返回此 |
| DisplayName |
返回适合在默认区域设置中向用户呈现的长标准时间名称 |
| DSTSavings |
返回要添加到本地标准时间以获取本地时钟时间的时间量。 (继承自 TimeZone) |
| Handle |
基础 Android 实例的句柄。 (继承自 Object) |
| ID |
获取此时区的 ID。 - 或 - 设置时区 ID。 (继承自 TimeZone) |
| JniIdentityHashCode |
|
| JniPeerMembers |
|
| PeerReference |
|
| RawOffset |
获取此时区的 GMT 偏移量。 |
| ThresholdClass |
此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。 |
| ThresholdType |
此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。 |
方法
| 名称 | 说明 |
|---|---|
| Clone() |
创建此 |
| Dispose() |
|
| Dispose(Boolean) |
|
| Equals(Object) |
指示其他对象是否“等于”此对象。 (继承自 Object) |
| GetDisplayName(Boolean, TimeZoneStyle, Locale) |
返回 |
| GetDisplayName(Boolean, TimeZoneStyle) |
返回一个名称,该名称 |
| GetDisplayName(Locale) |
返回适用于指定 |
| GetHashCode() |
返回对象的哈希代码值。 (继承自 Object) |
| GetOffset(Int32, Int32, Int32, Int32, Int32, Int32) |
返回本地时间和 UTC 之间的差(以毫秒为单位),同时考虑到指定日期和时间的原始偏移量和夏令时的效果。 |
| GetOffset(Int64) |
返回指定日期时此时区与 UTC 的偏移量。 (继承自 TimeZone) |
| HasSameRules(TimeZone) |
如果此区域与另一个区域具有相同的规则和偏移量,则返回 true。 (继承自 TimeZone) |
| InDaylightTime(Date) |
查询给定日期是否为夏令时。 |
| JavaFinalize() |
当垃圾回收确定不再引用该对象时,由对象上的垃圾回收器调用。 (继承自 Object) |
| Notify() |
唤醒正在等待此对象的监视器的单个线程。 (继承自 Object) |
| NotifyAll() |
唤醒正在等待此对象的监视器的所有线程。 (继承自 Object) |
| ObservesDaylightTime() |
如果 |
| SetDSTSavings(Int32) |
设置时钟在夏令时期间高级的时间(以毫秒为单位)。 |
| SetEndRule(Int32, Int32, Int32, Int32, Boolean) |
将夏令时结束规则设置为一个月内给定日期之前或之后的工作日,例如。 |
| SetEndRule(Int32, Int32, Int32, Int32) |
设置夏令时结束规则。 |
| SetEndRule(Int32, Int32, Int32) |
将夏令时结束规则设置为一个月内的固定日期。 |
| SetHandle(IntPtr, JniHandleOwnership) |
设置 Handle 属性。 (继承自 Object) |
| SetStartRule(Int32, Int32, Int32, Int32, Boolean) |
将夏令时开始规则设置为一个月内给定日期之前或之后的工作日,例如。 |
| SetStartRule(Int32, Int32, Int32, Int32) |
设置夏令时开始规则。 |
| SetStartRule(Int32, Int32, Int32) |
将夏令时开始规则设置为一个月内的固定日期。 |
| SetStartYear(Int32) |
设置从年份开始的夏令时。 |
| ToArray<T>() |
|
| ToString() |
返回对象的字符串表示形式。 (继承自 Object) |
| ToZoneId() |
将此 |
| UnregisterFromRuntime() |
|
| UseDaylightTime() |
查询此时区是否使用夏令时。 |
| Wait() |
使当前线程等待,直到唤醒它,通常是通过 em 通知/em< 或 >em<interrupted>/em<。><> (继承自 Object) |
| Wait(Int64, Int32) |
使当前线程等待直到唤醒,通常是通过 <em>通知</em> 或 <em interrupted>/em<>,或直到经过一定数量的实时。 (继承自 Object) |
| Wait(Int64) |
使当前线程等待直到唤醒,通常是通过 <em>通知</em> 或 <em interrupted>/em<>,或直到经过一定数量的实时。 (继承自 Object) |
显式接口实现
| 名称 | 说明 |
|---|---|
| IJavaPeerable.Disposed() |
|
| IJavaPeerable.DisposeUnlessReferenced() |
|
| IJavaPeerable.Finalized() |
|
| IJavaPeerable.JniManagedPeerState |
|
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
|
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
|
| IJavaPeerable.SetPeerReference(JniObjectReference) |
|
扩展方法
| 名称 | 说明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
获取实例 |
| JavaAs<TResult>(IJavaPeerable) |
尝试强制 |
| JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
|
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
尝试强制 |