DateTimeStyles 列舉
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
定義格式化選項,這些選項會自訂一些日期和時間剖析方法的字串剖析。
此列舉支援其成員值的位元組合。
public enum class DateTimeStyles
[System.Flags]
public enum DateTimeStyles
[System.Flags]
[System.Serializable]
public enum DateTimeStyles
[System.Flags]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public enum DateTimeStyles
[<System.Flags>]
type DateTimeStyles =
[<System.Flags>]
[<System.Serializable>]
type DateTimeStyles =
[<System.Flags>]
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type DateTimeStyles =
Public Enum DateTimeStyles
- 繼承
- 屬性
欄位
AdjustToUniversal | 16 | 日期和時間會以國際標準時間 (UTC) 傳回。 如果輸入字串代表當地時間 (透過時區規範或 AssumeLocal),則日期和時間會從當地時間轉換成 UTC。 如果輸入字串代表 UTC 時間 (透過時區規範或 AssumeUniversal),則不會進行轉換。 如果輸入字串並不代表當地時間或 UTC 時間,則不會進行轉換,而且產生的 Kind 屬性是 Unspecified。 這個值不可搭配 RoundtripKind 使用。 |
AllowInnerWhite | 4 | 除非字串中間的額外空白字元出現在 DateTimeFormatInfo 格式模式中,否則必須在剖析期間忽略這些空白字元。 |
AllowLeadingWhite | 1 | 除非前置空白字元出現在 DateTimeFormatInfo 格式模式中,否則必須在剖析期間忽略這些空白字元。 |
AllowTrailingWhite | 2 | 除非尾端空白字元出現在 DateTimeFormatInfo 格式模式中,否則必須在剖析期間忽略這些空白字元。 |
AllowWhiteSpaces | 7 | 除非字串中任意位置的額外空白字元出現在 DateTimeFormatInfo 格式模式中,否則必須在剖析期間忽略這些空白字元。 這個值是 AllowLeadingWhite、AllowTrailingWhite 和 AllowInnerWhite 值的組合。 |
AssumeLocal | 32 | 如果未在剖析字串中指定時區,則會假設字串是代表當地時間。 這個值不可搭配 AssumeUniversal 或 RoundtripKind 使用。 |
AssumeUniversal | 64 | 如果未在剖析字串中指定時區,則會假設字串是代表 UTC。 這個值不可搭配 AssumeLocal 或 RoundtripKind 使用。 |
NoCurrentDateDefault | 8 | 如果剖析字串只含時間而未含日期,則剖析方法會假設為西曆日期,其中年 = 1、月 = 1 而日 = 1。 如果未使用這個值,則假設為目前日期。 |
None | 0 | 必須使用預設格式化選項。 這個值表示 Parse(String)、ParseExact(String, String, IFormatProvider) 和 TryParse(String, DateTime) 方法的預設樣式。 |
RoundtripKind | 128 | 當 DateTime 物件使用 "o" 或 "r" 標準格式規範轉換成字串,而字串再轉換回 DateTime 物件時,會保留日期的 DateTimeKind 欄位。 |
備註
DateTimeStyles 值可以搭配下列任一 styles
日期和時間剖析方法使用,這些方法包含 參數,以定義可能存在於要剖析之字串中之樣式專案的解譯:
ParseExact
和 TryParseExact
方法可以使用任何DateTimeStyles值。 不過,如果沒有選取任何 Allow*
值,則輸入字串必須與格式字串完全相同的空格符。
如果輸入字串不包含時區的任何指示,日期和時間剖析方法會根據操作系統的時區設定來解譯日期和時間字串的值。 若要將日期和時間轉換為通用時間或 Greenwich Mean Time (GMT) ,應用程式應該使用 AdjustToUniversal 值。 呼叫 或 DateTimeOffset.ToUniversalTime 方法即可達到DateTime.ToUniversalTime相同的效果。 不過,搭配日期和時間剖析方法使用 AdjustToUniversal 值會更有效率。