DateTime 结构
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示一个即时时间，通常表示为日期和时间。
public value class DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattablepublic value class DateTime : IComparable, IConvertible, IFormattablepublic value class DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable, System::Runtime::Serialization::ISerializablepublic value class DateTime : IComparable, IComparable<DateTime>, IEquatable<DateTime>, IFormattablepublic struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable[System.Serializable]
public struct DateTime : IComparable, IConvertible, IFormattable[System.Serializable]
public struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable, System.Runtime.Serialization.ISerializablepublic struct DateTime : IComparable, IComparable<DateTime>, IEquatable<DateTime>, IFormattablepublic struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable, System.Runtime.Serialization.ISerializablepublic readonly struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable, System.Runtime.Serialization.ISerializabletype DateTime = struct
interface IConvertible
interface IFormattable[<System.Serializable>]
type DateTime = struct
interface IFormattable
interface IConvertible[<System.Serializable>]
type DateTime = struct
interface IFormattable
interface IConvertible
interface ISerializabletype DateTime = struct
interface IFormattabletype DateTime = struct
interface IConvertible
interface IFormattable
interface ISerializablePublic Structure DateTime
Implements IComparable, IComparable(Of DateTime), IConvertible, IEquatable(Of DateTime), IFormattablePublic Structure DateTime
Implements IComparable, IConvertible, IFormattablePublic Structure DateTime
Implements IComparable, IComparable(Of DateTime), IConvertible, IEquatable(Of DateTime), IFormattable, ISerializablePublic Structure DateTime
Implements IComparable, IComparable(Of DateTime), IEquatable(Of DateTime), IFormattable- 继承
- 属性
- 实现
注解
有关此 API 的详细信息，请参阅 DateTime 的补充 API 备注。
构造函数
字段
| 名称 | 说明 |
|---|---|
| MaxValue |
表示最大可能值 DateTime。 此字段是只读的。 |
| MinValue |
表示可能的最小值 DateTime。 此字段是只读的。 |
| UnixEpoch |
此常量的值等效于 1970 年 1 月 1 日，公历中的 00：00：00.0000000 UTC。 UnixEpoch 定义 Unix 时间等于 0 的时间点。 |
属性
| 名称 | 说明 |
|---|---|
| Date |
获取此实例的日期组件。 |
| Day |
获取此实例表示的月份的日期。 |
| DayOfWeek |
获取此实例表示的一周中的一天。 |
| DayOfYear |
获取此实例表示的一年中的某一天。 |
| Hour |
获取此实例所表示日期的小时部分。 |
| Kind |
获取一个值，该值指示此实例所表示的时间是基于本地时间、协调世界时（UTC），还是不基于这两个时间。 |
| Millisecond |
获取此实例所表示的日期的毫秒部分。 |
| Minute |
获取此实例所表示日期的分钟部分。 |
| Month |
获取此实例所表示日期的月份部分。 |
| Now |
获取一个 DateTime 对象，该对象设置为此计算机上的当前日期和时间，表示为本地时间。 |
| Second |
获取此实例所表示日期的秒部分。 |
| Ticks |
获取表示此实例的日期和时间的时钟周期数。 |
| TimeOfDay |
获取此实例的一天中的时间。 |
| Today |
获取当前日期。 |
| UtcNow |
获取一个 DateTime 对象，该对象设置为此计算机上的当前日期和时间，表示为协调世界时（UTC）。 |
| Year |
获取此实例所表示日期的年份部分。 |
方法
| 名称 | 说明 |
|---|---|
| Add(TimeSpan) | |
| AddDays(Double) |
返回一个新 DateTime 值，它将指定的天数添加到此实例的值。 |
| AddHours(Double) |
返回一个新 DateTime 值，它将指定的小时数添加到此实例的值。 |
| AddMilliseconds(Double) |
返回一个新 DateTime 值，它将指定的毫秒数添加到此实例的值。 |
| AddMinutes(Double) |
返回一个新 DateTime 值，该值将指定的分钟数添加到此实例的值。 |
| AddMonths(Int32) |
返回一个新 DateTime 值，它将指定的月份数添加到此实例的值。 |
| AddSeconds(Double) |
返回一个新 DateTime 值，它将指定的秒数添加到此实例的值。 |
| AddTicks(Int64) |
返回一个新 DateTime 值，它将指定的时钟周期数添加到此实例的值。 |
| AddYears(Int32) |
返回一个新 DateTime 值，该值将指定的年数添加到此实例的值。 |
| Compare(DateTime, DateTime) |
比较两个实例 DateTime 并返回一个整数，该整数指示第一个实例是早于、与第二个实例相同还是晚于第二个实例。 |
| CompareTo(DateTime) |
将此实例的值与指定的 DateTime 值进行比较，并返回一个整数，该值指示此实例是早于、与指定值相同还是晚于指定 DateTime 值。 |
| CompareTo(Object) |
将此实例的值与包含指定值的指定 DateTime 对象进行比较，并返回一个整数，该值指示此实例是早于、与指定值相同还是晚于指定 DateTime 值。 |
| DaysInMonth(Int32, Int32) |
返回指定月份和年份中的天数。 |
| Equals(DateTime, DateTime) |
返回一个值，该值指示两 DateTime 个实例是否具有相同的日期和时间值。 |
| Equals(DateTime) |
返回一个值，该值指示此实例的值是否等于指定 DateTime 实例的值。 |
| Equals(Object) |
返回一个值，该值指示此实例是否等于指定的对象。 |
| FromBinary(Int64) |
反序列化 64 位二进制值并重新创建原始序列化 DateTime 对象。 |
| FromFileTime(Int64) |
将指定的 Windows 文件时间转换为等效的本地时间。 |
| FromFileTimeUtc(Int64) |
将指定的 Windows 文件时间转换为等效的 UTC 时间。 |
| FromOADate(Double) |
返回 DateTime 等效于指定的 OLE 自动化日期。 |
| GetDateTimeFormats() |
将此实例的值转换为标准日期和时间格式说明符支持的所有字符串表示形式。 |
| GetDateTimeFormats(Char, IFormatProvider) |
将此实例的值转换为指定标准日期和时间格式说明符和区域性特定的格式信息支持的所有字符串表示形式。 |
| GetDateTimeFormats(Char) |
将此实例的值转换为指定标准日期和时间格式说明符支持的所有字符串表示形式。 |
| GetDateTimeFormats(IFormatProvider) |
将此实例的值转换为标准日期和时间格式说明符和指定区域性特定的格式信息支持的所有字符串表示形式。 |
| GetHashCode() |
返回此实例的哈希代码。 |
| GetTypeCode() | |
| IsDaylightSavingTime() |
指示此实例 DateTime 是否在当前时区的夏令时范围内。 |
| IsLeapYear(Int32) |
返回一个指示指定的年份是否为跃年。 |
| Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles) |
使用区域性特定的格式信息和格式样式将包含日期和时间字符串表示形式的内存范围转换为等效 DateTime 的内存范围。 |
| Parse(String, IFormatProvider, DateTimeStyles) |
使用区域性特定的格式信息和格式样式，将日期和时间的字符串表示形式转换为等效 DateTime 的字符串表示形式。 |
| Parse(String, IFormatProvider) |
使用区域性特定的格式信息将日期和时间的字符串表示形式转换为等效 DateTime 的字符串表示形式。 |
| Parse(String) |
使用当前区域性的约定将日期和时间的字符串表示形式转换为等效 DateTime 的字符串表示形式。 |
| ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles) |
使用指定的格式、区域性特定的格式信息和样式，将日期和时间的指定范围表示形式转换为等效 DateTime 的表示形式。 字符串表示形式的格式必须与指定的格式完全匹配或引发异常。 |
| ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles) |
使用指定的格式数组、区域性特定的格式信息和样式，将日期和时间的指定范围表示形式转换为等效 DateTime 的表示形式。 字符串表示形式的格式必须与指定格式中的至少一种格式完全匹配，否则引发异常。 |
| ParseExact(String, String, IFormatProvider, DateTimeStyles) |
使用指定的格式、区域性特定的格式信息和样式将日期和时间的指定字符串表示形式转换为等效 DateTime 的字符串表示形式。 字符串表示形式的格式必须与指定的格式完全匹配或引发异常。 |
| ParseExact(String, String, IFormatProvider) |
使用指定的格式和区域性特定格式信息将日期和时间的指定字符串表示形式转换为等效 DateTime 的字符串表示形式。 字符串表示形式的格式必须与指定的格式完全匹配。 |
| ParseExact(String, String[], IFormatProvider, DateTimeStyles) |
使用指定的格式数组、区域性特定的格式信息和样式将日期和时间的指定字符串表示形式转换为等效 DateTime 的字符串表示形式。 字符串表示形式的格式必须与指定格式中的至少一种格式完全匹配，否则引发异常。 |
| SpecifyKind(DateTime, DateTimeKind) |
创建一个新 DateTime 对象，其时钟周期数与指定 DateTime时间相同，但指定为本地时间、协调世界时（UTC），或两者均未指定，由指定 DateTimeKind 值指示。 |
| Subtract(DateTime) |
返回一个新 TimeSpan 值，该值从此实例的值中减去指定的日期和时间。 |
| Subtract(TimeSpan) |
返回一个新 DateTime 值，该值从此实例的值中减去指定的持续时间。 |
| ToBinary() | |
| ToFileTime() |
将当前 DateTime 对象的值转换为 Windows 文件时间。 |
| ToFileTimeUtc() |
将当前 DateTime 对象的值转换为 Windows 文件时间。 |
| ToLocalTime() |
将当前 DateTime 对象的值转换为本地时间。 |
| ToLongDateString() |
将当前 DateTime 对象的值转换为其等效的长日期字符串表示形式。 |
| ToLongTimeString() |
将当前 DateTime 对象的值转换为其等效的长字符串表示形式。 |
| ToOADate() |
将此实例的值转换为等效的 OLE 自动化日期。 |
| ToShortDateString() |
将当前 DateTime 对象的值转换为其等效的短日期字符串表示形式。 |
| ToShortTimeString() |
将当前 DateTime 对象的值转换为其等效的短时间字符串表示形式。 |
| ToString() |
使用当前区域性的格式约定将当前 DateTime 对象的值转换为其等效的字符串表示形式。 |
| ToString(IFormatProvider) |
使用指定的区域性特定格式信息将当前 DateTime 对象的值转换为其等效的字符串表示形式。 |
| ToString(String, IFormatProvider) |
使用指定的格式和区域性特定的格式信息将当前 DateTime 对象的值转换为其等效的字符串表示形式。 |
| ToString(String) |
使用指定的格式和当前区域性的格式约定，将当前 DateTime 对象的值转换为其等效的字符串表示形式。 |
| ToUniversalTime() |
将当前 DateTime 对象的值转换为协调世界时（UTC）。 |
| TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider) |
尝试将当前日期/时间实例的值格式化为提供的字符范围。 |
| TryParse(ReadOnlySpan<Char>, DateTime) |
将日期和时间的指定字符范围转换为其 DateTime 等效项，并返回一个值，该值指示转换是否成功。 |
| TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime) |
使用指定的区域性特定的格式信息和格式样式将日期和时间的跨度表示形式转换为等效 DateTime 格式，并返回一个值，该值指示转换是否成功。 |
| TryParse(String, DateTime) |
将日期和时间的指定字符串表示形式转换为等效 DateTime 项，并返回一个值，该值指示转换是否成功。 |
| TryParse(String, IFormatProvider, DateTimeStyles, DateTime) |
使用指定的区域性特定的格式信息和格式样式将日期和时间的指定字符串表示形式转换为等效 DateTime 格式，并返回一个值，该值指示转换是否成功。 |
| TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime) |
使用指定的格式、区域性特定的格式信息和样式，将日期和时间的指定范围表示形式转换为等效 DateTime 的表示形式。 字符串表示形式的格式必须与指定的格式完全匹配。 该方法返回一个值，该值指示转换是否成功。 |
| TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles, DateTime) |
将日期和时间的指定字符范围转换为其 DateTime 等效项，并返回一个值，该值指示转换是否成功。 |
| TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) |
使用指定的格式、区域性特定的格式信息和样式将日期和时间的指定字符串表示形式转换为等效 DateTime 的字符串表示形式。 字符串表示形式的格式必须与指定的格式完全匹配。 该方法返回一个值，该值指示转换是否成功。 |
| TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime) |
使用指定的格式数组、区域性特定的格式信息和样式将日期和时间的指定字符串表示形式转换为等效 DateTime 的字符串表示形式。 字符串表示形式的格式必须与指定格式中的至少一种格式完全匹配。 该方法返回一个值，该值指示转换是否成功。 |
运营商
| 名称 | 说明 |
|---|---|
| Addition(DateTime, TimeSpan) |
将指定的时间间隔添加到指定的日期和时间，从而生成新的日期和时间。 |
| Equality(DateTime, DateTime) |
确定两个 DateTime 指定实例是否相等。 |
| GreaterThan(DateTime, DateTime) | |
| GreaterThanOrEqual(DateTime, DateTime) | |
| Inequality(DateTime, DateTime) |
确定两个指定实例 DateTime 是否不相等。 |
| LessThan(DateTime, DateTime) | |
| LessThanOrEqual(DateTime, DateTime) | |
| Subtraction(DateTime, DateTime) |
从另一个指定的日期和时间中减去指定的日期和时间，并返回一个时间间隔。 |
| Subtraction(DateTime, TimeSpan) |
从指定的日期和时间中减去指定的时间间隔，并返回新的日期和时间。 |
显式接口实现
适用于
线程安全性
此类型的所有成员都是线程安全的。 似乎修改实例状态的成员实际上返回使用新值初始化的新实例。 与任何其他类型一样，读取和写入包含此类型的实例的共享变量必须受到锁的保护，以确保线程安全。