System::DateTime class
内容
[
隐藏
]DateTime class
表示时间连续体上的特定日期和时间值。此类型应在栈上分配，并通过值或引用传递给函数。切勿使用 System::SmartPtr 类来管理此类型的对象。
class DateTime
方法
| 方法 | 描述 |
|---|---|
| Add(TimeSpan) const | 返回一个新的 DateTime 类实例，表示将指定的时间跨度添加到当前对象表示的日期和时间值后得到的日期和时间值。 |
| AddDays(double) const | 返回一个新的 DateTime 类实例，表示当前对象表示的值与指定天数之和的日期和时间值。 |
| AddHours(double) const | 返回一个新的 DateTime 类实例，表示当前对象表示的值与指定小时数之和的日期和时间值。 |
| AddMilliseconds(double) const | 返回一个新的 DateTime 类实例，表示当前对象表示的值与指定毫秒数之和的日期和时间值。 |
| AddMinutes(double) const | 返回一个新的 DateTime 类实例，表示当前对象表示的值与指定分钟数之和的日期和时间值。 |
| AddMonths(int) const | 返回一个新的 DateTime 类实例，表示当前对象表示的值与指定月份数之和的日期和时间值。 |
| AddSeconds(double) const | 返回一个新的 DateTime 类实例，表示当前对象表示的值与指定秒数之和的日期和时间值。 |
| AddTicks(int64_t) const | 返回一个新的 DateTime 类实例，表示当前对象表示的值与指定的 100 纳秒间隔之和的日期和时间值。 |
| AddYears(int) const | 返回一个新的 DateTime 类实例，表示在当前对象表示的日期和时间值上将年份组件增加指定数量后的日期和时间值。 |
| static Compare(DateTime, DateTime) | 比较由指定的 DateTime 类实例表示的两个值，并返回指示这些值在时间线上相对位置的值。 |
| CompareTo(DateTime) const | 比较当前对象和指定的 DateTime 类实例表示的两个日期时间值，并返回指示这些值在时间线上相对位置的值。 |
| DateTime() | 构造一个实例，表示等于 MinValue 的最小可能日期和时间值。 |
| DateTime(int, int, int) | 构造一个实例，表示按特定年份、月份和日期指定的日期和时间值。 |
| DateTime(int, int, int, const SharedPtr<Globalization::Calendar>&) | 构造一个实例，表示在指定日历中按特定年份、月份和日期指定的日期和时间值。 |
| DateTime(int, int, int, int, int, int) | 构造一个实例，该实例表示指定的年份、月份、日期、小时、分钟和秒的日期时间值。 |
| DateTime(int, int, int, int, int, int, DateTimeKind) | 构造一个实例，该实例表示指定的年份、月份、日期、小时、分钟和秒的日期时间值。 |
| DateTime(int, int, int, int, int, int, const SharedPtr<Globalization::Calendar>&) | 构造一个实例，该实例表示在指定日历中指定的年份、月份、日期、小时、分钟和秒的日期时间值。 |
| DateTime(int, int, int, int, int, int, int, DateTimeKind) | 构造一个实例，该实例表示指定的年份、月份、日期、小时、分钟、秒和毫秒的日期时间值。 |
| DateTime(int, int, int, int, int, int, int, const SharedPtr<Globalization::Calendar>&, DateTimeKind) | 构造一个实例，该实例表示在指定日历中指定的年份、月份、日期、小时、分钟、秒和毫秒的日期时间值。 |
| DateTime(int64_t, DateTimeKind) | 构造一个实例，该实例表示以计数单位（ticks）数量指定的日期时间值。 |
| DateTime(int64_t, DateTimeKind, bool) | 构造一个实例，该实例表示以计数单位（ticks）数量指定的日期时间值。供内部使用。 |
| DateTime(const DateTime&) | 复制构造一个实例。 |
| static DaysInMonth(int, int) | 返回指定年份中指定月份的天数。 |
| static Equals(DateTime, DateTime) | 确定指定的 DateTime 类实例是否表示相同的日期时间值。 |
| Equals(DateTime) const | 确定指定的 DateTime 类实例是否表示与当前对象相同的日期时间值。 |
| static FromBinary(int64_t) | 从指定的无符号 64 位整数反序列化日期时间值，并将新的 DateTime 类实例设置为该值。 |
| static FromFileTime(int64_t) | 将指定的文件时间转换为 DateTime 类实例，表示与本地时间相同的日期时间值。 |
| static FromFileTimeUtc(int64_t) | 将指定的文件时间转换为 DateTime 类实例，表示与 UTC 时间相同的日期时间值。 |
| static FromOADate(double) | 返回一个 DateTime 类实例，表示等效于指定 OLE 自动化日期的日期时间值。 |
| static FromUnixTime(time_t) | 将指定的 Unix 时间值转换为 DateTime 类实例。供内部使用。 |
| get_Date() const | 返回一个新的 DateTime 类实例，该实例表示当前对象所表示的日期时间的日期部分，并将时间部分的各组件设为 0。 |
| get_Day() const | 返回当前对象所表示的月份中日期的序号。 |
| get_DayOfWeek() const | 返回一个表示当前对象所表示的星期几的值。 |
| get_DayOfYear() const | 返回当前对象所表示的年份中日期的序号。 |
| get_Hour() const | 返回当前对象所表示的日期时间值的小时组件。 |
| get_Kind() const | 返回一个值，表示当前对象所表示的日期时间是本地时间、UTC 时间还是两者都不是。 |
| get_Millisecond() const | 返回当前对象所表示的日期时间值的毫秒组件。 |
| get_Minute() const | 返回当前对象所表示的日期时间值的分钟组件。 |
| get_Month() const | 返回当前对象所表示的年份中月份的序号。 |
| static get_Now() | 返回一个 DateTime 类实例，表示当前本地时间。 |
| get_Second() const | 返回当前对象表示的日期时间值的秒组件。 |
| get_Ticks() const | 返回自公元 0001 年 1 月 1 日 0:00:00 UTC（格里高利历）以来，到当前对象表示的日期时间为止的 100 纳秒间隔数。 |
| get_TimeOfDay() const | 返回表示从当前对象表示的当天开始到当前对象表示的日期时间值之间的时间间隔的值。 |
| static get_Today() | 返回一个 DateTime 类的实例，该实例表示当前日期，并将对象表示的值的时间部分的每个组件设置为 0。 |
| static get_UtcNow() | 返回一个 DateTime 类的实例，该实例表示当前时间（UTC）。 |
| get_Year() const | 返回当前对象表示的年份。 |
| GetDateComponents(int&, int&, int&) const | 获取日期部分。仅供内部使用。 |
| GetDateTimeFormats() const | 返回字符串数组，其中每个元素是使用标准日期时间格式说明符之一格式化的当前对象的字符串表示。 |
| GetDateTimeFormats(char_t) const | 返回字符串数组，其中每个元素是使用指定的标准日期时间格式说明符格式化的当前对象的字符串表示。 |
| GetDateTimeFormats(const SharedPtr<IFormatProvider>&) const | 返回字符串数组，其中每个元素是使用标准日期时间格式说明符之一以及指定的格式提供程序格式化的当前对象的字符串表示。 |
| GetDateTimeFormats(char_t, const SharedPtr<IFormatProvider>&) const | 返回字符串数组，其中每个元素是使用指定的标准日期时间格式说明符和格式提供程序格式化的当前对象的字符串表示。 |
| GetHashCode() const | 返回当前对象的哈希码。 |
| IsDaylightSavingTime() const | 确定当前对象表示的日期时间值是否位于当前时区的夏令时范围内。 |
| static IsLeapYear(int) | 确定指定的年份是否为闰年。 |
| IsNull() const | |
| operator!=(DateTime) const | 确定当前对象和指定的 DateTime 对象是否表示不同的日期时间值。 |
| operator!=(std::nullptr_t) const | |
| operator+(TimeSpan) const | 返回一个新的 DateTime 类实例，该实例表示当前对象表示的值与指定时间跨度之和的日期时间值。 |
| operator+=(TimeSpan) | 将当前对象设置为当前对象表示的值与指定时间跨度之和的日期时间值。 |
| operator-(TimeSpan) const | 返回一个新的 DateTime 类实例，表示从当前对象表示的值减去指定时间跨度后的日期时间值。 |
| operator-(DateTime) const | 返回一个 TimeSpan 类实例，表示当前对象和指定对象所表示的日期和时间值之间的时间间隔。 |
| operator-=(TimeSpan) | 将当前对象设置为从当前对象表示的日期时间值减去指定时间跨度后的日期时间值。 |
| operator<(DateTime) const | 确定当前对象表示的日期时间值是否早于指定的 DateTime 对象表示的值。 |
| operator<(std::nullptr_t) const | |
| operator<=(DateTime) const | 确定当前对象表示的日期时间值是否早于或等于指定的 DateTime 对象表示的值。 |
| operator<=(std::nullptr_t) const | |
| operator=(const DateTime&) | 将指定的 DateTime 实例表示的值赋给当前对象。 |
| operator==(DateTime) const | 确定当前对象和指定的 DateTime 对象是否表示相同的日期时间值。 |
| operator==(std::nullptr_t) const | |
| operator>(DateTime) const | 确定当前对象表示的日期时间值是否晚于指定的 DateTime 对象表示的值。 |
| operator>(std::nullptr_t) const | |
| operator>=(DateTime) const | 确定当前对象表示的日期时间值是否晚于或等于指定的 DateTime 对象表示的值。 |
| operator>=(std::nullptr_t) const | |
| static Parse(const String&) | 将指定的日期时间值的字符串表示转换为等效的 DateTime 对象。 |
| static Parse(const String&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles) | 使用特定于文化的格式信息，将指定的日期时间值的字符串表示转换为等效的 DateTime 对象。 |
| static Parse(const String&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles) | |
| static Parse(const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles) | |
| static Parse(const String&, std::nullptr_t, Globalization::DateTimeStyles) | |
| static ParseExact(const String&, const String&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles) | 使用指定的格式和特定于文化的格式信息，将指定的日期时间值的字符串表示转换为等效的 DateTime 对象。字符串表示的格式必须完全匹配指定的格式。如果转换失败，将抛出异常。 |
| static ParseExact(const String&, const String&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles) | |
| static ParseExact(const String&, const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles) | |
| static ParseExact(const String&, const String&, std::nullptr_t, Globalization::DateTimeStyles) | |
| static ParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles) | 使用指定的格式集合、特定于文化的格式信息和样式，将指定的日期时间值的字符串表示转换为等效的 DateTime 对象。字符串表示的格式必须完全匹配一个或多个指定的格式。如果转换失败，将抛出异常。 |
| static ParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles) | |
| static ParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles) | |
| static ParseExact(const String&, const ArrayPtr<String>&, std::nullptr_t, Globalization::DateTimeStyles) | |
| static SpecifyKind(DateTime, DateTimeKind) | 构造一个新的 DateTime 对象，该对象表示与指定的 DateTime 对象相同的刻度数，并根据参数 kind 指定为本地时间、UTC 时间或两者皆非。 |
| Subtract(TimeSpan) const | 返回一个新的 DateTime 类实例，表示从当前对象表示的值减去指定时间跨度后的日期时间值。 |
| Subtract(DateTime) const | 返回一个 TimeSpan 类的实例，表示当前对象和指定对象所表示的日期时间值之间的时间间隔。 |
| ToBinary() const | 序列化当前对象。 |
| ToFileTime() const | 返回一个值，以文件时间形式表示当前对象所表示的日期时间值。 |
| ToFileTimeUtc() const | 将当前对象所表示的日期时间值转换为 UTC 文件时间。 |
| ToLocalTime() const | 返回一个新的 DateTime 类实例，以本地时间形式表示当前对象所表示的日期时间值。 |
| ToLongDateString() const | 返回一个字符串，包含当前对象的长日期字符串表示。 |
| ToLongTimeString() const | 返回一个字符串，包含当前对象的长时间字符串表示。 |
| ToOADate() const | 返回当前对象所表示的日期时间值，以 OLE Automation 日期形式。 |
| ToShortDateString() const | 返回一个字符串，包含当前对象的短日期字符串表示。 |
| ToShortTimeString() const | 返回一个字符串，包含当前对象的短时间字符串表示。 |
| ToString() const | 使用当前文化定义的格式约定，返回当前对象所表示的日期时间值的字符串表示。 |
| ToString(const String&) const | 使用指定的格式以及当前文化定义的格式约定，返回当前对象所表示的日期时间值的字符串表示。 |
| ToString(const SharedPtr<IFormatProvider>&) const | 使用指定的格式信息，返回当前对象所表示的日期时间值的字符串表示。 |
| ToString(const SharedPtr<Globalization::CultureInfo>&) const | |
| ToString(const SharedPtr<Globalization::DateTimeFormatInfo>&) const | |
| ToString(std::nullptr_t) const | |
| ToString(const String&, const SharedPtr<IFormatProvider>&) const | 使用指定的格式信息，返回当前对象所表示的日期时间值的字符串表示。 |
| ToString(const String&, const SharedPtr<Globalization::CultureInfo>&) const | |
| ToString(const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&) const | |
| ToString(const String&, std::nullptr_t) const | |
| ToUniversalTime() const | 返回一个新的 DateTime 类实例，以 UTC 形式表示当前对象所表示的日期时间值。 |
| ToUnixTime() const | 返回一个值，以 Unix 时间形式表示当前对象所表示的日期时间值。供内部使用。 |
| static TryParse(const String&, DateTime&) | 将指定的日期时间值的字符串表示转换为等效的 DateTime 对象。 |
| static TryParse(const String&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles, DateTime&) | 使用指定的特定于文化的格式信息和样式，将指定的日期时间值的字符串表示转换为等效的 DateTime 对象。 |
| static TryParse(const String&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles, DateTime&) | |
| static TryParse(const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles, DateTime&) | |
| static TryParse(const String&, std::nullptr_t, Globalization::DateTimeStyles, DateTime&) | |
| static TryParseExact(const String&, const String&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles, DateTime&) | 使用指定的格式、特定于文化的格式信息和样式，将指定的日期时间值的字符串表示转换为等效的 DateTime 对象。字符串表示的格式必须完全匹配指定的格式。 |
| static TryParseExact(const String&, const String&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles, DateTime&) | |
| static TryParseExact(const String&, const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles, DateTime&) | |
| static TryParseExact(const String&, const String&, std::nullptr_t, Globalization::DateTimeStyles, DateTime&) | |
| static TryParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles, DateTime&) | 使用指定的格式集合、特定于文化的格式信息和样式，将指定的日期时间值的字符串表示转换为等效的 DateTime 对象。字符串表示的格式必须完全匹配一个或多个指定的格式。 |
| static TryParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles, DateTime&) | |
| static TryParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles, DateTime&) | |
| static TryParseExact(const String&, const ArrayPtr<String>&, std::nullptr_t, Globalization::DateTimeStyles, DateTime&) | |
| static Type() | 返回一个 TypeInfo 对象，其中包含关于此类的信息。 |
字段
| 字段 | 描述 |
|---|---|
| static constexpr MaxTicks | 最小可能和最大可能的 DateTime 值之间的时间间隔中包含的 100 纳秒计数。 |
| static MaxValue | 一个 DateTime 类的实例，表示可能的最大日期时间值。 |
| static constexpr MinTicks | 实例 DateTime 类可以表示的最小滴答数。 |
| static MinValue | 表示可能的最小日期和时间值的 DateTime 类实例。 |
| static constexpr TicksPerDay | 一天中的滴答数。 |
| static constexpr TicksPerHour | 一小时中的滴答数。 |
| static constexpr TicksPerMicrosecond | 一微秒中的滴答数。 |
| static constexpr TicksPerMillisecond | 一毫秒中的滴答数。 |
| static constexpr TicksPerMinute | 一分钟中的滴答数。 |
| static constexpr TicksPerSecond | 一秒中的滴答数。 |
| static UnixEpoch | 表示 Unix 纪元起始时间 (1970.01.01 00:00:00) 的 DateTime 类实例。 |
备注
#include "system/console.h"
#include "system/date_time.h"
int main()
{
using namespace System;
// 创建 'DateTime' 类实例。
DateTime dateTime{1990, 10, 30};
// 以多种格式打印该实例。
Console::WriteLine(dateTime.ToShortDateString());
Console::WriteLine(dateTime.ToShortTimeString());
Console::WriteLine(dateTime.ToString());
return 0;
}
/*
This code example produces the following output:
30.10.1990
0:00
30.10.1990 0:00:00
*/
另见
- Namespace System
- Library Aspose.Page for C++
