System::DateTimeOffset 类

DateTimeOffset class

包含相对于协调世界时的日期和时间。此类的对象只能使用 System::MakeObject() 函数分配。切勿在栈上或使用 operator new 创建此类型的实例，因为这会导致运行时错误和/或断言故障。始终将此类包装到 System::SmartPtr 指针中，并使用该指针在函数调用时作为参数传递。

class DateTimeOffset

方法

方法描述
Add(TimeSpan) const向 DateTimeOffset 对象添加指定的时间间隔。
AddDays(double) const向 DateTimeOffset 对象添加指定天数。
AddHours(double) const向 DateTimeOffset 对象添加指定小时数。
AddMilliseconds(double) const向 DateTimeOffset 对象添加指定毫秒数。
AddMinutes(double) const向 DateTimeOffset 对象添加指定分钟数。
AddMonths(int) const向 DateTimeOffset 对象添加指定月数。
AddSeconds(double) const向 DateTimeOffset 对象添加指定秒数。
AddTicks(int64_t) const向 DateTimeOffset 对象添加指定数量的刻度。
AddYears(int) const向 DateTimeOffset 对象添加指定数量的年。
static Compare(const DateTimeOffset&, const DateTimeOffset&)比较两个 DateTimeOffset 对象。
CompareTo(const DateTimeOffset&) const比较两个 DateTimeOffset 对象。
CompareTo(const SharedPtr<Object>&) const比较两个 DateTimeOffset 对象。
DateTimeOffset()默认构造函数。
DateTimeOffset(DateTime)构造函数。
DateTimeOffset(int64_t, TimeSpan)构造函数。
DateTimeOffset(DateTime, TimeSpan)构造函数。
DateTimeOffset(int, int, int, int, int, int, TimeSpan)构造函数。
DateTimeOffset(int, int, int, int, int, int, int, TimeSpan)构造函数。
DateTimeOffset(int, int, int, int, int, int, int, const SharedPtr<Globalization::Calendar>&, TimeSpan)构造函数。
static Equals(const DateTimeOffset&, const DateTimeOffset&)检查两个 DateTimeOffset 对象是否表示相同的时间点。
Equals(const DateTimeOffset&) const检查两个 DateTimeOffset 对象是否表示相同的时间点。
Equals(const SharedPtr<Object>&) const检查两个 DateTimeOffset 对象是否表示相同的时间点。
EqualsExact(const DateTimeOffset&) const检查两个 DateTimeOffset 对象是否表示相同的时间点并具有相同的偏移量。
EqualsExact(const SharedPtr<Object>&) const检查两个 DateTimeOffset 对象是否表示相同的时间点并具有相同的偏移量。
static FromFileTime(int64_t)ConvertWindows 文件时间转换为带本地时间偏移的日期和时间。
static FromUnixTimeMilliseconds(int64_t)Convert 将 Unix 时间转换为 DateTimeOffset 对象。
static FromUnixTimeSeconds(int64_t)Convert 将 Unix 时间转换为 DateTimeOffset 对象。
get_Date() const获取当前对象的日期部分。
get_DateTime() const获取 DateTime 值。
get_Day() const获取当前对象的月份天数。
get_DayOfWeek() const获取当前对象的星期几。
get_DayOfYear() const获取当前对象的年内天数。
get_Hour() const获取当前对象的小时部分。
get_LocalDateTime() const获取表示本地日期和时间的 DateTime 值。
get_Millisecond() const获取当前对象的毫秒部分。
get_Minute() const获取当前对象的分钟部分。
get_Month() const获取当前对象的月份部分。
static get_Now()获取 DateTimeOffset，其日期和时间设置为当前本地时间，且偏移量设置为本地时间的偏移量。
get_Offset() const获取相对于 UTC 的偏移量。
get_Second() const获取当前对象的秒数部分。
get_Ticks() const获取当前对象的刻度数。
get_TimeOfDay() const获取当前对象的当天时间。
get_UtcDateTime() const获取表示 UTC 日期和时间的 DateTime 值。
static get_UtcNow()获取 DateTimeOffset，其日期和时间设置为当前 UTC 时间，且偏移量为 TimeSpan::Zero。
get_UtcTicks() const获取当前对象在 UTC 时间中的刻度数。
get_Year() const获取当前对象的年份组件。
GetHashCode() const获取当前 DateTimeOffset 对象的哈希码。
IsNull() const
operator!=(const DateTimeOffset&) const确定当前对象和指定的 DateTimeOffset 对象是否表示不同的日期和时间值。
operator!=(std::nullptr_t) const
operator+(TimeSpan) const返回一个新的 DateTimeOffset 类实例，表示当前对象表示的值与指定时间跨度之和的日期和时间值。
operator-(TimeSpan) const返回一个新的 DateTimeOffset 类实例，表示从当前对象表示的值减去指定时间跨度后的日期和时间值。
operator-(const DateTimeOffset&) const返回一个 TimeSpan 类的实例，表示当前对象和指定对象所表示的日期时间值之间的时间间隔。
operator<(const DateTimeOffset&) const确定当前对象表示的日期时间值是否早于指定的 DateTimeOffset 对象所表示的值。
operator<(std::nullptr_t) const
operator<=(const DateTimeOffset&) const确定当前对象表示的日期时间值是否早于或等于指定的 DateTimeOffset 对象所表示的值。
operator<=(std::nullptr_t) const
operator==(const DateTimeOffset&) const确定当前对象和指定的 DateTimeOffset 对象是否表示相同的日期和时间值。
operator==(std::nullptr_t) const
operator>(const DateTimeOffset&) const确定当前对象表示的日期时间值是否晚于指定的 DateTimeOffset 对象所表示的值。
operator>(std::nullptr_t) const
operator>=(const DateTimeOffset&) const确定当前对象表示的日期时间值是否晚于或等于指定的 DateTimeOffset 对象所表示的值。
operator>=(std::nullptr_t) const
static Parse(const String&)将指定的字符串转换为等价的 DateTimeOffset。
static Parse(const String&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles)使用指定的格式提供程序和格式化样式，将指定的字符串转换为 DateTimeOffset 对象。
static ParseExact(const String&, const String&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles)使用指定的格式、格式提供程序和格式化样式，将指定的字符串转换为 DateTimeOffset 对象。
static ParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles)使用指定的格式集合、格式提供程序和格式化样式，将指定的字符串转换为 DateTimeOffset 对象。
Subtract(TimeSpan) const从当前对象中减去指定的时间间隔。
Subtract(const DateTimeOffset&) const从当前对象中减去指定的 DateTimeOffset 值。
ToFileTime() const将当前对象转换为 Windows 文件时间。
ToLocalTime() const将当前对象转换为表示本地时间的对象。
ToOffset(TimeSpan) const使用指定的偏移量替换当前对象的偏移量。
ToString(const String&, const SharedPtr<IFormatProvider>&) const使用指定的格式和格式提供程序，将当前对象转换为字符串。
ToString(const SharedPtr<IFormatProvider>&) const使用指定的格式提供程序，将当前对象转换为字符串。
ToString(const String&) const使用指定的格式，将当前对象转换为字符串。
ToString() const将当前对象转换为字符串。
ToUniversalTime() const将当前对象转换为表示 UTC 时间的对象，.
ToUnixTimeMilliseconds() const获取自 Unix 纪元开始以来经过的毫秒数。
ToUnixTimeSeconds() const获取自 Unix 纪元开始以来经过的秒数。
static TryParse(const String&, DateTimeOffset&)尝试将指定的字符串转换为 DateTimeOffset 对象。
static TryParse(const String&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles, DateTimeOffset&)尝试使用指定的格式提供程序和格式化样式将指定的字符串转换为 DateTimeOffset 对象。
static TryParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles, DateTimeOffset&)尝试使用指定的格式集合、格式提供程序和格式化样式将指定的字符串转换为 DateTimeOffset 对象。
static TryParseExact(const String&, const String&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles, DateTimeOffset&)尝试使用指定的格式、格式提供程序和格式化样式将指定的字符串转换为 DateTimeOffset 对象。
static Type()返回一个表示 TimeSpan 结构的 TypeInfo 对象。

字段

字段描述
static constexpr MaxOffset获取以刻度为单位的最大偏移量。
static MaxValue获取最大的 DateTimeOffset 值。
static constexpr MinOffset获取以刻度为单位的最小偏移量。
static MinValue获取最早的 DateTimeOffset 值。
static UnixEpoch获取 Unix 纪元的起始时间。

另见

System::DateTime 类 System::DBNull 类