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 引進)

備註

如果您的 app 會將此類別中使用的語言標籤傳遞給任何 國家語言支援 函式，則必須先呼叫 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	取得目前Hour的第一分鐘。
FirstMonthInThisYear	取得目前年份的第一個月。
FirstPeriodInThisDay	取得目前日期的第一個期間。
FirstSecondInThisMinute	取得目前Minute的第一秒。
FirstYearInThisEra	取得目前紀元的第一年。
Hour	取得或設定小時。
IsDaylightSavingTime	取得 布林值 ，指出日光節約時間是否在此 Calendar 物件的日期生效。
Languages	取得將元件格式化為字串時所使用的語言識別項優先順序清單。
LastDayInThisMonth	取得目前月份的最後一天。
LastEra	取得行事曆中可用的最後一個 紀元 。
LastHourInThisPeriod	取得目前期間的最後一小時。
LastMinuteInThisHour	取得目前Hour的最後一分鐘。
LastMonthInThisYear	取得目前年份的最後一個月。
LastPeriodInThisDay	取得目前日期的最後一個期間。
LastSecondInThisMinute	取得目前Minute的最後一秒。
LastYearInThisEra	取得目前紀元的最後一年。
Minute	取得或設定分鐘。
Month	取得或設定月份。
Nanosecond	取得或設定 nanosecond。
NumberOfDaysInThisMonth	取得此 Calendar 物件目前月份的天數。
NumberOfEras	取得這個 Calendar 物件中的紀元數目。
NumberOfHoursInThisPeriod	取得這個 Calendar 物件的目前日期週期中的時數。
NumberOfMinutesInThisHour	取得目前Hour中的分鐘數。
NumberOfMonthsInThisYear	取得這個 Calendar 物件目前年份中的月數。
NumberOfPeriodsInThisDay	取得此 Calendar 物件目前日期的期間數。
NumberOfSecondsInThisMinute	取得目前Minute中的秒數。
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 早于、等於或晚于另一個物件的 日期時間 。
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)	傳回 nanosecond 的字串表示，選擇性地以零填補。
NanosecondAsString()	傳回字串，其中包含 nanosecond 的數值表示。
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)
• 針對日本紀元變更準備您的應用程式