Date 类

参考

定义

命名空间:: Java.Util

程序集:: Mono.Android.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

该类 Date 以毫秒精度表示特定的时间实例。

[Android.Runtime.Register("java/util/Date", DoNotGenerateAcw=true)]
public class Date : Java.Lang.Object, IDisposable, Java.Interop.IJavaPeerable, Java.IO.ISerializable, Java.Lang.ICloneable, Java.Lang.IComparable

[<Android.Runtime.Register("java/util/Date", DoNotGenerateAcw=true)>]
type Date = class
    inherit Object
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface ICloneable
    interface IComparable

继承: Object

Object
Date

派生: Java.Sql.Date

Java.Sql.Time

Java.Sql.Timestamp

属性: RegisterAttribute

实现: IJavaObject IJavaPeerable ISerializable ICloneable IComparable IDisposable

注解

该类 Date 以毫秒精度表示特定的时间实例。

在 JDK 之前;1.1，类 Date 有两个额外的函数。它允许将日期解释为年、月、日、小时、分钟和秒值。它还允许对日期字符串进行格式设置和分析。遗憾的是，这些函数的 API 不适用于国际化。从 JDK 起;1.1，类 Calendar 应用于在日期和时间字段之间进行转换， DateFormat 类应用于格式化和分析日期字符串。已弃用相应的方法 Date 。

尽管该 Date 类旨在反映协调世界时（UTC），但根据 Java 虚拟机的主机环境，它可能不会完全反映。几乎所有新式操作系统都假定为 1 day = 24 × 60 × 在所有情况下，60 = 86400 秒。然而，在 UTC，大约每年或两次有一个额外的秒，称为“跃第二”。第二个跃点始终添加为当天的最后一秒，始终在 12 月 31 日或 6 月 30 日。例如，由于增加了跳跃秒，1995年的最后一分钟长61秒。大多数计算机时钟不够准确，无法反映 leap-second 区别。

一些计算机标准在格林威治平均时间（GMT）方面进行了定义，这相当于世界时（UT）。 GMT 是标准的“民事”名称;UT 是同一标准的“科学”名称。 UTC 和 UT 之间的区别在于，UTC 基于原子时钟，UT 基于天文观测，出于所有实际目的，这是一种无法辨别的细头发。由于地球的旋转不统一（它以复杂的方式减慢速度），因此UT并不总是均匀流动。在 UTC 中根据需要引入 Leap 秒，以便在 UT1 的 0.9 秒内保留 UTC，这是应用了某些更正的 UT 版本。还有其他时间和日期系统：例如，基于卫星的全球定位系统（GPS）使用的时间刻度将同步到 UTC，但不会在跳跃秒内进行调整。一个有趣的进一步信息来源是美国海军天文台（USNO）：<块状>

<a href="http://www.usno.navy.mil/USNO">http://www.usno.navy.mil/USNO</a>

</blockquote>

以及有关“时间系统”的材料： <blockquote>

<a href="http://www.usno.navy.mil/USNO/time/master-clock/systems-of-time">http://www.usno.navy.mil/USNO/time/master-clock/systems-of-time</a>

</blockquote>

其中包含各种不同时间系统的说明，包括 UT、UT1 和 UTC。

在接受或返回年份、月、日期、小时、分钟和秒值的类Date的所有方法中，使用以下表示形式：<ul<>li>A year y 由整数 y - 1900 表示。 <li>A 月由 0 到 11 的整数表示;0 为 1 月，1 为 2 月，依此类推;因此 11 为 12 月。 <li>A date （月日）以一般方式用 1 到 31 的整数表示。 <li>An 小时由一个介于 0 到 23 的整数表示。因此，从午夜到凌晨1点的小时是0小时，从中午到晚上1点的小时是12小时。 <li>A 分钟以从 0 到 59 的整数表示，通常方式为 0 到 59。 <li>A 秒由介于 0 到 61 之间的整数表示;值 60 和 61 只发生在 leap 秒，甚至在实际跟踪跃秒的 Java 实现中才会发生。由于目前引入跳跃秒的方式，不太可能在同一分钟内发生两个跃秒，但此规范遵循 ISO C 的日期和时间约定。 </ul>

在所有情况下，为这些目的提供给方法的参数不需要位于指示的范围内;例如，日期可以指定为 1 月 32 日，并解释为表示 2 月 1 日。

在 1.0 中添加。

适用于 . 的 java.util.DateJava 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改，并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

构造函数

Date()	分配一个 `Date` 对象并初始化它，以便它表示它分配的时间，测量到最接近的毫秒。
Date(Int32, Int32, Int32)	已过时. 分配一个对象并初始化它，以便它表示由 Date/> 指定的`yearmonth`一天开头的午夜、本地时间以及`date`参数。
Date(Int32, Int32, Int32, Int32, Int32)	已过时. 分配一个`Date`对象并初始化它，以便它表示本地时区中由参数指定的`minyearmonthdatehrs`分钟开头的即时。
Date(Int32, Int32, Int32, Int32, Int32, Int32)	已过时. 分配一个`Date`对象并初始化它，以便它表示本地时区中第二个对象所指定的 `hrssecyearmonthdatemin`秒开始时的即时。
Date(Int64)	分配一个 `Date` 对象并将其初始化，以表示自标准基准时间（即 1970 年 1 月 1 日 00：00：00：00 GMT）以来指定的毫秒数。
Date(IntPtr, JniHandleOwnership)	创建 JNI 对象的托管表示形式时使用的构造函数;由运行时调用。
Date(String)	已过时. 分配一个 `Date` 对象并初始化它，以便它表示字符串所指示的日期和时间，该字符串 `s`被解释为方法 `Date#parse` 。

属性

Class	返回此 `Object`的运行时类。 (继承自 Object)
Day	已过时. 返回此日期所表示的一周中的某一天。
Handle	基础 Android 实例的句柄。 (继承自 Object)
Hours	已过时. 返回此 `Date` 对象表示的小时。 - 或 - 将此 `Date` 对象的小时数设置为指定的值。
JniIdentityHashCode	该类 `Date` 以毫秒精度表示特定的时间实例。 (继承自 Object)
JniPeerMembers	该类 `Date` 以毫秒精度表示特定的时间实例。
Minutes	已过时. 返回此日期所表示的小时之前的分钟数，如本地时区中解释的那样。 - 或 - 将此对象的分钟 `Date` 数设置为指定的值。
Month	已过时. 返回一个数字，表示包含或以此 `Date` 对象所表示的即时时间开始的月份。 - 或 - 将此日期的月份设置为指定值。
PeerReference	该类 `Date` 以毫秒精度表示特定的时间实例。 (继承自 Object)
Seconds	已过时. 返回此日期所表示的分钟数。 - 或 - 将此值 `Date` 的秒设置为指定值。
ThresholdClass	此 API 支持 Mono for Android 基础结构，不打算直接从代码使用。
ThresholdType	此 API 支持 Mono for Android 基础结构，不打算直接从代码使用。
Time	返回自 1970 年 1 月 1 日 00：00：00：00 GMT 表示以来的 `Date` 毫秒数。 - 或 - 将此 `Date` 对象设置为表示在 1970 年 1 月 1 日 00：00：00 GMT 之后的毫秒时间 `time` 点。
TimezoneOffset	已过时. 返回相对于 UTC 的本地时区的偏移量（以分钟为单位），该偏移量适合此 `Date` 对象表示的时间。
Year	已过时. 返回一个值，该值是从包含或以此 `Date` 对象所表示的即时时间开始的年份中减去 1900 的结果，如本地时区中解释的那样。 - 或 - 将此 `Date` 对象的年份设置为指定值加上 1900。

方法

After(Date)	测试此日期是否在指定日期之后。
Before(Date)	测试此日期是否在指定日期之前。
Clone()	返回此对象的副本。
CompareTo(Date)	比较两个排序日期。
Dispose()	该类 `Date` 以毫秒精度表示特定的时间实例。 (继承自 Object)
Dispose(Boolean)	该类 `Date` 以毫秒精度表示特定的时间实例。 (继承自 Object)
Equals(Object)	指示其他对象是否“等于”此对象。 (继承自 Object)
From(Instant)	从`Instant`对象获取实例`Date`。
GetDate()	已过时. 返回此 `Date` 对象表示的月份的日期。
GetHashCode()	返回对象的哈希代码值。 (继承自 Object)
JavaFinalize()	当垃圾回收确定不再引用该对象时，由对象上的垃圾回收器调用。 (继承自 Object)
Notify()	唤醒正在等待此对象的监视器的单个线程。 (继承自 Object)
NotifyAll()	唤醒正在等待此对象的监视器的所有线程。 (继承自 Object)
Parse(String)	已过时. 尝试将字符串 `s` 解释为日期和时间的表示形式。
SetDate(Int32)	已过时. 将此 `Date` 对象的月份日期设置为指定值。
SetHandle(IntPtr, JniHandleOwnership)	设置 Handle 属性。 (继承自 Object)
ToArray<T>()	该类 `Date` 以毫秒精度表示特定的时间实例。 (继承自 Object)
ToGMTString()	已过时. 创建此形式的此 `Date` 对象的字符串表示形式： <blockquote>
ToInstant()	将此 `Date` 对象转换为 `Instant`.
ToLocaleString()	已过时. 以依赖实现的形式创建此 `Date` 对象的字符串表示形式。
ToString()	返回对象的字符串表示形式。 (继承自 Object)
UnregisterFromRuntime()	该类 `Date` 以毫秒精度表示特定的时间实例。 (继承自 Object)
UTC(Int32, Int32, Int32, Int32, Int32, Int32)	已过时. 根据参数确定日期和时间。
Wait()	使当前线程等待，直到唤醒它，通常是通过 em 通知/em> 或 <em>interrupted</em>。<>< (继承自 Object)
Wait(Int64)	使当前线程等待直到唤醒，通常是通过 <em>通知</em> 或 <em interrupted</em>>，或直到经过一定数量的实时。 (继承自 Object)
Wait(Int64, Int32)	使当前线程等待直到唤醒，通常是通过 <em>通知</em> 或 <em interrupted</em>>，或直到经过一定数量的实时。 (继承自 Object)

显式接口实现

IComparable.CompareTo(Object)	该类 `Date` 以毫秒精度表示特定的时间实例。
IJavaPeerable.Disposed()	该类 `Date` 以毫秒精度表示特定的时间实例。 (继承自 Object)
IJavaPeerable.DisposeUnlessReferenced()	该类 `Date` 以毫秒精度表示特定的时间实例。 (继承自 Object)
IJavaPeerable.Finalized()	该类 `Date` 以毫秒精度表示特定的时间实例。 (继承自 Object)
IJavaPeerable.JniManagedPeerState	该类 `Date` 以毫秒精度表示特定的时间实例。 (继承自 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	该类 `Date` 以毫秒精度表示特定的时间实例。 (继承自 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	该类 `Date` 以毫秒精度表示特定的时间实例。 (继承自 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	该类 `Date` 以毫秒精度表示特定的时间实例。 (继承自 Object)

扩展方法

JavaCast<TResult>(IJavaObject)	执行 Android 运行时检查的类型转换。
JavaCast<TResult>(IJavaObject)	该类 `Date` 以毫秒精度表示特定的时间实例。
GetJniTypeName(IJavaPeerable)	该类 `Date` 以毫秒精度表示特定的时间实例。

适用于

通过

Date 类

定义

注解

构造函数

属性

方法

显式接口实现

扩展方法

适用于

其他资源