DateTimeFormatter 建構函式

參考

定義

命名空間:: Windows.Globalization.DateTimeFormatting

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

DateTimeFormatter(String)	建立由格式範本字串初始化的 DateTimeFormatter 物件。
DateTimeFormatter(String, IIterable<String>)	建立由格式範本字串和語言清單初始化的 DateTimeFormatter 物件。
DateTimeFormatter(HourFormat, MinuteFormat, SecondFormat)	建立以小時、分鐘和秒格式初始化的 DateTimeFormatter 物件。
DateTimeFormatter(YearFormat, MonthFormat, DayFormat, DayOfWeekFormat)	建立以年、月、日和周格式初始化的 DateTimeFormatter 物件。
DateTimeFormatter(String, IIterable<String>, String, String, String)	建立由格式範本字串、語言清單、地理區域、行事曆和時鐘初始化的 DateTimeFormatter 物件。
DateTimeFormatter(YearFormat, MonthFormat, DayFormat, DayOfWeekFormat, HourFormat, MinuteFormat, SecondFormat, IIterable<String>)	建立 DateTimeFormatter 物件，此物件是以年、月、日、周的日、小時、分鐘和秒格式初始化，以及語言清單。
DateTimeFormatter(YearFormat, MonthFormat, DayFormat, DayOfWeekFormat, HourFormat, MinuteFormat, SecondFormat, IIterable<String>, String, String, String)	建立指定所有格式和識別碼的 DateTimeFormatter 物件。

DateTimeFormatter(String)

編輯

建立由格式範本字串初始化的 DateTimeFormatter 物件。

public:
 DateTimeFormatter(Platform::String ^ formatTemplate);

 DateTimeFormatter(winrt::hstring const& formatTemplate);

public DateTimeFormatter(string formatTemplate);

function DateTimeFormatter(formatTemplate)

Public Sub New (formatTemplate As String)

參數

formatTemplate: String
Platform::String

winrt::hstring

指定所要求元件的格式範本字串。元件的順序無關。這也可以是格式模式。如需有效格式範本和格式模式的清單，請參閱 DateTimeFormatter 類別的備註。

另請參閱

適用於

DateTimeFormatter(String, IIterable<String>)

編輯

建立由格式範本字串和語言清單初始化的 DateTimeFormatter 物件。

public:
 DateTimeFormatter(Platform::String ^ formatTemplate, IIterable<Platform::String ^> ^ languages);

 DateTimeFormatter(winrt::hstring const& formatTemplate, IIterable<winrt::hstring> const& languages);

public DateTimeFormatter(string formatTemplate, IEnumerable<string> languages);

function DateTimeFormatter(formatTemplate, languages)

Public Sub New (formatTemplate As String, languages As IEnumerable(Of String))

參數

formatTemplate: String
Platform::String

winrt::hstring

指定所要求元件的格式範本字串。元件的順序無關。這也可以是格式模式。如需有效格式範本和格式模式的清單，請參閱 DateTimeFormatter 類別的備註。

languages: IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

以優先順序表示語言選擇的語言識別項清單。這些識別碼用於將範本解析為模式和格式設定。請參閱＜備註＞。

備註

如果您的 app 會將此類別中使用的語言標籤傳遞給任何國家語言支援函式，則必須先呼叫 ResolveLocaleName來轉換標籤。

語言標籤支援 Unicode 延伸模組「ca-」和「nu-」。 (請參閱 Unicode 索引鍵/類型定義.) 注意，這些延伸模組可能會影響 Calendar 物件所使用的行事曆。

另請參閱

適用於

DateTimeFormatter(HourFormat, MinuteFormat, SecondFormat)

編輯

建立以小時、分鐘和秒格式初始化的 DateTimeFormatter 物件。

public:
 DateTimeFormatter(HourFormat hourFormat, MinuteFormat minuteFormat, SecondFormat secondFormat);

 DateTimeFormatter(HourFormat const& hourFormat, MinuteFormat const& minuteFormat, SecondFormat const& secondFormat);

public DateTimeFormatter(HourFormat hourFormat, MinuteFormat minuteFormat, SecondFormat secondFormat);

function DateTimeFormatter(hourFormat, minuteFormat, secondFormat)

Public Sub New (hourFormat As HourFormat, minuteFormat As MinuteFormat, secondFormat As SecondFormat)

參數

hourFormat: HourFormat

要包含在範本中的所需小時格式。

minuteFormat: MinuteFormat

要包含在範本中的所需分鐘格式。

secondFormat: SecondFormat

要包含在範本中的所需第二種格式。

另請參閱

適用於

DateTimeFormatter(YearFormat, MonthFormat, DayFormat, DayOfWeekFormat)

編輯

建立以年、月、日和周格式初始化的 DateTimeFormatter 物件。

public:
 DateTimeFormatter(YearFormat yearFormat, MonthFormat monthFormat, DayFormat dayFormat, DayOfWeekFormat dayOfWeekFormat);

 DateTimeFormatter(YearFormat const& yearFormat, MonthFormat const& monthFormat, DayFormat const& dayFormat, DayOfWeekFormat const& dayOfWeekFormat);

public DateTimeFormatter(YearFormat yearFormat, MonthFormat monthFormat, DayFormat dayFormat, DayOfWeekFormat dayOfWeekFormat);

function DateTimeFormatter(yearFormat, monthFormat, dayFormat, dayOfWeekFormat)

Public Sub New (yearFormat As YearFormat, monthFormat As MonthFormat, dayFormat As DayFormat, dayOfWeekFormat As DayOfWeekFormat)

參數

yearFormat: YearFormat

要包含在範本中的所需年份格式。

monthFormat: MonthFormat

要包含在範本中的所需月份格式。

dayFormat: DayFormat

要包含在範本中的所需日期格式。

dayOfWeekFormat: DayOfWeekFormat

要包含在範本中的所需星期數格式。

另請參閱

適用於

DateTimeFormatter(String, IIterable<String>, String, String, String)

編輯

建立由格式範本字串、語言清單、地理區域、行事曆和時鐘初始化的 DateTimeFormatter 物件。

public:
 DateTimeFormatter(Platform::String ^ formatTemplate, IIterable<Platform::String ^> ^ languages, Platform::String ^ geographicRegion, Platform::String ^ calendar, Platform::String ^ clock);

 DateTimeFormatter(winrt::hstring const& formatTemplate, IIterable<winrt::hstring> const& languages, winrt::hstring const& geographicRegion, winrt::hstring const& calendar, winrt::hstring const& clock);

public DateTimeFormatter(string formatTemplate, IEnumerable<string> languages, string geographicRegion, string calendar, string clock);

function DateTimeFormatter(formatTemplate, languages, geographicRegion, calendar, clock)

Public Sub New (formatTemplate As String, languages As IEnumerable(Of String), geographicRegion As String, calendar As String, clock As String)

參數

formatTemplate: String
Platform::String

winrt::hstring

指定所要求元件的格式範本字串。元件的順序無關。這也可以是格式模式。如需有效格式範本和格式模式的清單，請參閱 DateTimeFormatter 類別的備註。

languages: IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

以優先順序表示語言選擇的語言識別項清單。這些識別碼用於將範本解析為模式，以及格式化。請參閱＜備註＞。

geographicRegion: String
Platform::String

winrt::hstring

地理區域的識別碼。此識別碼用於將範本解析為模式。

calendar: String
Platform::String

winrt::hstring

要使用的行事曆識別碼。

clock: String
Platform::String

winrt::hstring

要使用的時鐘識別碼。

備註

如果您的 app 會將此類別中使用的語言標籤傳遞給任何國家語言支援函式，則必須先呼叫 ResolveLocaleName來轉換標籤。

語言標籤支援 Unicode 延伸模組「ca-」和「nu-」。 (請參閱 Unicode 索引鍵/類型定義.) 注意，這些延伸模組可能會影響 Calendar 物件所使用的行事曆。

另請參閱

適用於

DateTimeFormatter(YearFormat, MonthFormat, DayFormat, DayOfWeekFormat, HourFormat, MinuteFormat, SecondFormat, IIterable<String>)

編輯

建立 DateTimeFormatter 物件，此物件是以年、月、日、周的日、小時、分鐘和秒格式初始化，以及語言清單。

public:
 DateTimeFormatter(YearFormat yearFormat, MonthFormat monthFormat, DayFormat dayFormat, DayOfWeekFormat dayOfWeekFormat, HourFormat hourFormat, MinuteFormat minuteFormat, SecondFormat secondFormat, IIterable<Platform::String ^> ^ languages);

 DateTimeFormatter(YearFormat const& yearFormat, MonthFormat const& monthFormat, DayFormat const& dayFormat, DayOfWeekFormat const& dayOfWeekFormat, HourFormat const& hourFormat, MinuteFormat const& minuteFormat, SecondFormat const& secondFormat, IIterable<winrt::hstring> const& languages);

public DateTimeFormatter(YearFormat yearFormat, MonthFormat monthFormat, DayFormat dayFormat, DayOfWeekFormat dayOfWeekFormat, HourFormat hourFormat, MinuteFormat minuteFormat, SecondFormat secondFormat, IEnumerable<string> languages);

function DateTimeFormatter(yearFormat, monthFormat, dayFormat, dayOfWeekFormat, hourFormat, minuteFormat, secondFormat, languages)

Public Sub New (yearFormat As YearFormat, monthFormat As MonthFormat, dayFormat As DayFormat, dayOfWeekFormat As DayOfWeekFormat, hourFormat As HourFormat, minuteFormat As MinuteFormat, secondFormat As SecondFormat, languages As IEnumerable(Of String))

參數

yearFormat: YearFormat

要包含在範本中的年份格式。

monthFormat: MonthFormat

要包含在範本中的月份格式。

dayFormat: DayFormat

要包含在範本中的日期格式。

dayOfWeekFormat: DayOfWeekFormat

要包含在範本中的星期數格式。

hourFormat: HourFormat

要包含在範本中的小時格式。

minuteFormat: MinuteFormat

要包含在範本中的分鐘格式。

secondFormat: SecondFormat

要包含在範本中的第二種格式。

languages: IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

以優先順序表示語言選擇的語言識別項清單。這些識別碼用於將範本解析為模式和格式設定。請參閱＜備註＞。

備註

如果您的 app 會將此類別中使用的語言標籤傳遞給任何國家語言支援函式，則必須先呼叫 ResolveLocaleName來轉換標籤。

語言標籤支援 Unicode 延伸模組「ca-」和「nu-」。 (請參閱 Unicode 索引鍵/類型定義.) 注意，這些延伸模組可能會影響 Calendar 物件所使用的行事曆。

另請參閱

適用於

DateTimeFormatter(YearFormat, MonthFormat, DayFormat, DayOfWeekFormat, HourFormat, MinuteFormat, SecondFormat, IIterable<String>, String, String, String)

編輯

建立指定所有格式和識別碼的 DateTimeFormatter 物件。

public:
 DateTimeFormatter(YearFormat yearFormat, MonthFormat monthFormat, DayFormat dayFormat, DayOfWeekFormat dayOfWeekFormat, HourFormat hourFormat, MinuteFormat minuteFormat, SecondFormat secondFormat, IIterable<Platform::String ^> ^ languages, Platform::String ^ geographicRegion, Platform::String ^ calendar, Platform::String ^ clock);

 DateTimeFormatter(YearFormat const& yearFormat, MonthFormat const& monthFormat, DayFormat const& dayFormat, DayOfWeekFormat const& dayOfWeekFormat, HourFormat const& hourFormat, MinuteFormat const& minuteFormat, SecondFormat const& secondFormat, IIterable<winrt::hstring> const& languages, winrt::hstring const& geographicRegion, winrt::hstring const& calendar, winrt::hstring const& clock);

public DateTimeFormatter(YearFormat yearFormat, MonthFormat monthFormat, DayFormat dayFormat, DayOfWeekFormat dayOfWeekFormat, HourFormat hourFormat, MinuteFormat minuteFormat, SecondFormat secondFormat, IEnumerable<string> languages, string geographicRegion, string calendar, string clock);

function DateTimeFormatter(yearFormat, monthFormat, dayFormat, dayOfWeekFormat, hourFormat, minuteFormat, secondFormat, languages, geographicRegion, calendar, clock)

Public Sub New (yearFormat As YearFormat, monthFormat As MonthFormat, dayFormat As DayFormat, dayOfWeekFormat As DayOfWeekFormat, hourFormat As HourFormat, minuteFormat As MinuteFormat, secondFormat As SecondFormat, languages As IEnumerable(Of String), geographicRegion As String, calendar As String, clock As String)

參數

yearFormat: YearFormat

要包含在範本中的所需年份格式。

monthFormat: MonthFormat

要包含在範本中的所需月份格式。

dayFormat: DayFormat

要包含在範本中的所需日期格式。

dayOfWeekFormat: DayOfWeekFormat

要包含在範本中的所需星期數格式。

hourFormat: HourFormat

要包含在範本中的所需小時格式。

minuteFormat: MinuteFormat

要包含在範本中的所需分鐘格式。

secondFormat: SecondFormat

要包含在範本中的所需第二種格式。

languages: IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

以優先順序表示語言選擇的語言識別項清單。這些識別碼用於將範本解析為模式，以及格式化。請參閱＜備註＞。

geographicRegion: String
Platform::String

winrt::hstring

地理區域的識別碼。此識別碼用於將範本解析為模式。

calendar: String
Platform::String

winrt::hstring

要使用的行事曆識別碼。

clock: String
Platform::String

winrt::hstring

要使用的時鐘識別碼。

備註

如果您的 app 會將此類別中使用的語言標籤傳遞給任何國家語言支援函式，則必須先呼叫 ResolveLocaleName來轉換標籤。

語言標籤支援 Unicode 延伸模組「ca-」和「nu-」。 (請參閱 Unicode 索引鍵/類型定義.) 注意，這些延伸模組可能會影響 Calendar 物件所使用的行事曆。

另請參閱

適用於

DateTimeFormatter 建構函式

定義

多載

DateTimeFormatter(String)

參數

另請參閱

適用於

DateTimeFormatter(String, IIterable<String>)

參數

備註

另請參閱

適用於

DateTimeFormatter(HourFormat, MinuteFormat, SecondFormat)

參數

另請參閱

適用於

DateTimeFormatter(YearFormat, MonthFormat, DayFormat, DayOfWeekFormat)

參數

另請參閱

適用於

DateTimeFormatter(String, IIterable<String>, String, String, String)

參數

備註

另請參閱

適用於

DateTimeFormatter(YearFormat, MonthFormat, DayFormat, DayOfWeekFormat, HourFormat, MinuteFormat, SecondFormat, IIterable<String>)

參數

備註

另請參閱

適用於

DateTimeFormatter(YearFormat, MonthFormat, DayFormat, DayOfWeekFormat, HourFormat, MinuteFormat, SecondFormat, IIterable<String>, String, String, String)

參數

備註

另請參閱

適用於

意見反應

意見反應

其他資源