Calendar 类

定义

命名空间:

Windows.Globalization

操作给定日历和时钟中 DateTime 的表示形式。

public ref class Calendar sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Globalization.ICalendarFactory2, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(Windows.Globalization.ICalendarFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class Calendar final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Globalization.ICalendarFactory2), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Globalization.ICalendarFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class Calendar

function Calendar(languages, calendar, clock, timeZoneId)

Public NotInheritable Class Calendar

继承

Object Platform::Object IInspectable Calendar

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

如果你的应用将此类中使用的语言标记传递给任何 国家语言支持 函数，它必须首先通过调用 ResolveLocaleName 来转换标记。

语言标记支持 Unicode 扩展“ca-”和“nu-”。 (请参阅 Unicode 键/类型定义。) 请注意，这些扩展可能会影响 Calendar 对象使用的日历。

构造函数

Calendar()	创建一个 Calendar 对象，并将其初始化为当前 DateTime。
Calendar(IIterable<String>)	创建使用语言列表初始化的 Calendar 对象。
Calendar(IIterable<String>, String, String)	创建使用语言列表、日历和时钟初始化的 Calendar 对象。
Calendar(IIterable<String>, String, String, String)	创建使用语言列表、日历、时钟和时区初始化的 Calendar 对象。

属性

Day	获取或设置日期。
DayOfWeek	获取一周中的某一天。
Era	获取或设置纪元。
FirstDayInThisMonth	获取当前月份的第一天。
FirstEra	获取日历中可用的第一个 纪元 。
FirstHourInThisPeriod	获取当前期间的第一小时。
FirstMinuteInThisHour	获取当前小时的第一分钟。
FirstMonthInThisYear	获取当前年份的第一个月。
FirstPeriodInThisDay	获取当前日期的第一个时间段。
FirstSecondInThisMinute	获取当前 Minute 的第一秒。
FirstYearInThisEra	获取当前纪元的第一年。
Hour	获取或设置小时。
IsDaylightSavingTime	获取一个 布尔值 ，该值指示夏令时是否对此 Calendar 对象的日期有效。
Languages	获取在将组件格式化为字符串时使用的语言标识符的优先级列表。
LastDayInThisMonth	获取当前月份的最后一天。
LastEra	获取日历中最后一个可用的 纪元 。
LastHourInThisPeriod	获取当前期间的最后一小时。
LastMinuteInThisHour	获取当前 Hour 的最后一分钟。
LastMonthInThisYear	获取当前年份的最后一个月。
LastPeriodInThisDay	获取当前日期的最后一个时间段。
LastSecondInThisMinute	获取当前 Minute 的最后一秒。
LastYearInThisEra	获取当前纪元的最后一年。
Minute	获取或设置分钟。
Month	获取或设置月份。
Nanosecond	获取或设置纳秒。
NumberOfDaysInThisMonth	获取此 Calendar 对象的当前月份中的天数。
NumberOfEras	获取此 Calendar 对象中的纪元数。
NumberOfHoursInThisPeriod	获取此 Calendar 对象的当前时段中的小时数。
NumberOfMinutesInThisHour	获取当前 Hour 中的分钟数。
NumberOfMonthsInThisYear	获取此 Calendar 对象的当前年份中的月数。
NumberOfPeriodsInThisDay	获取此 Calendar 对象的当前日期中的时间段数。
NumberOfSecondsInThisMinute	获取当前分钟中的秒数。
NumberOfYearsInThisEra	获取此 Calendar 对象的当前纪元中的年数。
NumeralSystem	获取或设置在将组件格式化为字符串时使用的编号系统。
Period	获取或设置当天的时间段。
ResolvedLanguage	获取最近用于执行日历格式设置或操作的语言。
Second	获取或设置第二个。
Year	获取或设置年份。

方法

AddDays(Int32)	递增或递减一天。
AddEras(Int32)	递增或递减纪元。
AddHours(Int32)	递增或递减小时。
AddMinutes(Int32)	递增或递减分钟。
AddMonths(Int32)	递增或递减月份。
AddNanoseconds(Int32)	递增或递减纳秒。
AddPeriods(Int32)	递增或递减周期。
AddSeconds(Int32)	递增或递减秒。
AddWeeks(Int32)	按指定的周数递增或递减一天。
AddYears(Int32)	递增或递减年份。
ChangeCalendarSystem(String)	设置此 Calendar 对象要使用的新 日历 系统。
ChangeClock(String)	设置此 Calendar 对象要使用的新时钟。
ChangeTimeZone(String)	设置此 Calendar 对象要使用的新时区。
Clone()	创建 Calendar 对象的副本。
Compare(Calendar)	将此日历与另一个 Calendar 对象进行比较，并指示其中一个对象的 DateTime 是早于、等于还是晚于另一个对象的 DateTime 。
CompareDateTime(DateTime)	将此日历与 DateTime 对象进行比较，并指示一个日历的日期和时间是早于、等于还是晚于另一个对象的日期和时间。
CopyTo(Calendar)	将值从另一个 Calendar 对象复制到此 Calendar 中。
DayAsPaddedString(Int32)	返回日期的字符串表示形式，可以选择填充为零。
DayAsString()	返回一个字符串，其中包含日期的数字表示形式。
DayOfWeekAsSoloString()	返回适合独立显示的星期几的字符串表示形式。
DayOfWeekAsSoloString(Int32)	返回适合独立显示的星期几的字符串表示形式。
DayOfWeekAsString()	返回适合与其他日期组件一起包含的星期几的字符串表示形式。
DayOfWeekAsString(Int32)	返回适合与其他日期组件一起包含的星期几的字符串表示形式。
EraAsString()	返回纪元的字符串表示形式。
EraAsString(Int32)	返回纪元的字符串表示形式。 所选字符串的长度与理想长度最接近。
GetCalendarSystem()	获取此 Calendar 对象使用的 日历 系统。
GetClock()	获取此 Calendar 对象使用的时钟。
GetDateTime()	在给定此 Calendar 对象的组件的情况下生成日期和时间。
GetTimeZone()	获取标识此 Calendar 对象使用的时区的标识符。
HourAsPaddedString(Int32)	返回小时的字符串表示形式，可以选择填充为零。
HourAsString()	返回一个字符串，其中包含小时的数字表示形式。
MinuteAsPaddedString(Int32)	返回分钟（可选为零填充）的字符串表示形式。
MinuteAsString()	返回一个字符串，其中包含分钟的数字表示形式。
MonthAsNumericString()	返回一个字符串，其中包含月份的数字表示形式。
MonthAsPaddedNumericString(Int32)	返回月份的字符串表示形式，可以选择填充为零。
MonthAsSoloString()	返回适合独立显示的月份的字符串表示形式。
MonthAsSoloString(Int32)	返回适合独立显示的月份的字符串表示形式。
MonthAsString()	返回适合与其他日期组件一起包含的月份的字符串表示形式。
MonthAsString(Int32)	返回适合与其他日期组件一起包含的月份的字符串表示形式。
NanosecondAsPaddedString(Int32)	返回纳秒的字符串表示形式，可选择填充为零。
NanosecondAsString()	返回一个字符串，其中包含纳秒的数字表示形式。
PeriodAsString()	返回使用最常见的可用缩写的日期时间段（如 AM 或 PM）的字符串表示形式。
PeriodAsString(Int32)	返回日期时间段的字符串表示形式，例如 AM 或 PM。
SecondAsPaddedString(Int32)	返回第二个的字符串表示形式，可以选择零填充。
SecondAsString()	返回一个字符串，其中包含第二个的数字表示形式。
SetDateTime(DateTime)	将所有日期和时间字段设置为 DateTime 参数表示的日期和时间。
SetToMax()	将此 Calendar 对象的组件设置为支持的最新 DateTime 。
SetToMin()	将此 Calendar 对象的组件设置为支持的最早 DateTime 。
SetToNow()	将此 Calendar 对象的组件设置为当前 DateTime。
TimeZoneAsString()	返回此 Calendar 对象表示的时间点适用的完整时区名称。
TimeZoneAsString(Int32)	返回在此 Calendar 对象表示的时间点适用的缩写时区名称。
YearAsPaddedString(Int32)	返回年份的字符串表示形式（可选为零填充）。
YearAsString()	返回年份的字符串表示形式，没有任何初始零填充。
YearAsTruncatedString(Int32)	返回年份的字符串表示形式，可以选择截断。

另请参阅

• 日历、日期和时间控件
• 日历示例
• 设置日期和时间格式示例
• 全球化首选项示例 (Windows 10)
• 准备你的应用程序以进行日本纪元更改