DateTimeFormatInfo.NativeCalendarName 屬性

定義

命名空間:

System.Globalization

組件:

System.Runtime.dll

組件:

netstandard.dll

組件:

mscorlib.dll

取得行事曆的原生 (Native) 名稱，這個行事曆與目前 DateTimeFormatInfo 物件關聯。

public:
 property System::String ^ NativeCalendarName { System::String ^ get(); };

public string NativeCalendarName { get; }

[System.Runtime.InteropServices.ComVisible(false)]
public string NativeCalendarName { get; }

member this.NativeCalendarName : string

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.NativeCalendarName : string

Public ReadOnly Property NativeCalendarName As String

屬性值

String

如果有原生行事曆名稱可用，則為用於文化特性中與目前 DateTimeFormatInfo 物件相關聯之行事曆的原生名稱，如果沒有原生行事曆名稱可用，則為空字串 ("")。

屬性

ComVisibleAttribute

範例

下列範例會示範數種方法和屬性，這些方法和屬性會指定日期和時間格式模式、原生行事曆名稱，以及完整和縮寫的月份和日期名稱。

// This code example demonstrates the DateTimeFormatInfo
// MonthGenitiveNames, AbbreviatedMonthGenitiveNames,
// ShortestDayNames, and NativeCalendarName properties, and
// the GetShortestDayName() and SetAllDateTimePatterns() methods.

using System;
using System.Globalization;

class Sample
{
    public static void Main()
    {
    string[] myDateTimePatterns = new string[] {"MM/dd/yy", "MM/dd/yyyy"};

// Get the en-US culture.
    CultureInfo ci = new CultureInfo("en-US");
// Get the DateTimeFormatInfo for the en-US culture.
    DateTimeFormatInfo dtfi = ci.DateTimeFormat;

// Display the effective culture.
    Console.WriteLine("This code example uses the {0} culture.", ci.Name);

// Display the native calendar name.
    Console.WriteLine("\nNativeCalendarName...");
    Console.WriteLine("\"{0}\"", dtfi.NativeCalendarName);

// Display month genitive names.
    Console.WriteLine("\nMonthGenitiveNames...");
    foreach (string name in dtfi.MonthGenitiveNames)
    {
    Console.WriteLine("\"{0}\"", name);
    }

// Display abbreviated month genitive names.
    Console.WriteLine("\nAbbreviatedMonthGenitiveNames...");
    foreach (string name in dtfi.AbbreviatedMonthGenitiveNames)
    {
    Console.WriteLine("\"{0}\"", name);
    }

// Display shortest day names.
    Console.WriteLine("\nShortestDayNames...");
    foreach (string name in dtfi.ShortestDayNames)
    {
    Console.WriteLine("\"{0}\"", name);
    }

// Display shortest day name for a particular day of the week.
    Console.WriteLine("\nGetShortestDayName(DayOfWeek.Sunday)...");
    Console.WriteLine("\"{0}\"", dtfi.GetShortestDayName(DayOfWeek.Sunday));

// Display the initial DateTime format patterns for the 'd' format specifier.
    Console.WriteLine("\nInitial DateTime format patterns for the 'd' format specifier...");
    foreach (string name in dtfi.GetAllDateTimePatterns('d'))
    {
    Console.WriteLine("\"{0}\"", name);
    }

// Change the initial DateTime format patterns for the 'd' DateTime format specifier.
    Console.WriteLine("\nChange the initial DateTime format patterns for the \n" +
                      "'d' format specifier to my format patterns...");
    dtfi.SetAllDateTimePatterns(myDateTimePatterns, 'd');

// Display the new DateTime format patterns for the 'd' format specifier.
    Console.WriteLine("\nNew DateTime format patterns for the 'd' format specifier...");
    foreach (string name in dtfi.GetAllDateTimePatterns('d'))
    {
    Console.WriteLine("\"{0}\"", name);
    }
    }
}
/*
This code example produces the following results:

This code example uses the en-US culture.

NativeCalendarName...
"Gregorian Calendar"

MonthGenitiveNames...
"January"
"February"
"March"
"April"
"May"
"June"
"July"
"August"
"September"
"October"
"November"
"December"
""

AbbreviatedMonthGenitiveNames...
"Jan"
"Feb"
"Mar"
"Apr"
"May"
"Jun"
"Jul"
"Aug"
"Sep"
"Oct"
"Nov"
"Dec"
""

ShortestDayNames...
"Su"
"Mo"
"Tu"
"We"
"Th"
"Fr"
"Sa"

GetShortestDayName(DayOfWeek.Sunday)...
"Su"

Initial DateTime format patterns for the 'd' format specifier...
"M/d/yyyy"
"M/d/yy"
"MM/dd/yy"
"MM/dd/yyyy"
"yy/MM/dd"
"yyyy-MM-dd"
"dd-MMM-yy"

Change the initial DateTime format patterns for the
'd' format specifier to my format patterns...

New DateTime format patterns for the 'd' format specifier...
"MM/dd/yy"
"MM/dd/yyyy"

*/

' This code example demonstrates the DateTimeFormatInfo 
' MonthGenitiveNames, AbbreviatedMonthGenitiveNames, 
' ShortestDayNames, and NativeCalendarName properties, and
' the GetShortestDayName() and SetAllDateTimePatterns() methods.

Imports System.Globalization

Class Sample
    Public Shared Sub Main() 
        Dim myDateTimePatterns() As String = {"MM/dd/yy", "MM/dd/yyyy"}
        Dim name As String = ""
        
        ' Get the en-US culture.
        Dim ci As New CultureInfo("en-US")
        ' Get the DateTimeFormatInfo for the en-US culture.
        Dim dtfi As DateTimeFormatInfo = ci.DateTimeFormat
        
        ' Display the effective culture.
        Console.WriteLine("This code example uses the {0} culture.", ci.Name)
        
        ' Display the native calendar name.    
        Console.WriteLine(vbCrLf & "NativeCalendarName...")
        Console.WriteLine("""{0}""", dtfi.NativeCalendarName)
        
        ' Display month genitive names.
        Console.WriteLine(vbCrLf & "MonthGenitiveNames...")
        For Each name In dtfi.MonthGenitiveNames
            Console.WriteLine("""{0}""", name)
        Next name
        
        ' Display abbreviated month genitive names.
        Console.WriteLine(vbCrLf & "AbbreviatedMonthGenitiveNames...")
        For Each name In dtfi.AbbreviatedMonthGenitiveNames
            Console.WriteLine("""{0}""", name)
        Next name
        
        ' Display shortest day names.
        Console.WriteLine(vbCrLf & "ShortestDayNames...")
        For Each name In dtfi.ShortestDayNames
            Console.WriteLine("""{0}""", name)
        Next name
        
        ' Display shortest day name for a particular day of the week.
        Console.WriteLine(vbCrLf & "GetShortestDayName(DayOfWeek.Sunday)...")
        Console.WriteLine("""{0}""", dtfi.GetShortestDayName(DayOfWeek.Sunday))
        
        ' Display the initial DateTime format patterns for the 'd' format specifier.
        Console.WriteLine(vbCrLf & "Initial DateTime format patterns for " & _
                          "the 'd' format specifier...")
        For Each name In dtfi.GetAllDateTimePatterns("d"c)
            Console.WriteLine("""{0}""", name)
        Next name
        
        ' Change the initial DateTime format patterns for the 'd' DateTime format specifier.
        Console.WriteLine(vbCrLf & "Change the initial DateTime format patterns for the " & _
                          vbCrLf & "'d' format specifier to my format patterns...")
        dtfi.SetAllDateTimePatterns(myDateTimePatterns, "d"c)
        
        ' Display the new DateTime format patterns for the 'd' format specifier.
        Console.WriteLine(vbCrLf & _
                          "New DateTime format patterns for the 'd' format specifier...")
        For Each name In dtfi.GetAllDateTimePatterns("d"c)
            Console.WriteLine("""{0}""", name)
        Next name
    
    End Sub
End Class
'
'This code example produces the following results:
'
'This code example uses the en-US culture.
'
'NativeCalendarName...
'"Gregorian Calendar"
'
'MonthGenitiveNames...
'"January"
'"February"
'"March"
'"April"
'"May"
'"June"
'"July"
'"August"
'"September"
'"October"
'"November"
'"December"
'""
'
'AbbreviatedMonthGenitiveNames...
'"Jan"
'"Feb"
'"Mar"
'"Apr"
'"May"
'"Jun"
'"Jul"
'"Aug"
'"Sep"
'"Oct"
'"Nov"
'"Dec"
'""
'
'ShortestDayNames...
'"Su"
'"Mo"
'"Tu"
'"We"
'"Th"
'"Fr"
'"Sa"
'
'GetShortestDayName(DayOfWeek.Sunday)...
'"Su"
'
'Initial DateTime format patterns for the 'd' format specifier...
'"M/d/yyyy"
'"M/d/yy"
'"MM/dd/yy"
'"MM/dd/yyyy"
'"yy/MM/dd"
'"yyyy-MM-dd"
'"dd-MMM-yy"
'
'Change the initial DateTime format patterns for the
''d' format specifier to my format patterns...
'
'New DateTime format patterns for the 'd' format specifier...
'"MM/dd/yy"
'"MM/dd/yyyy"
'

給呼叫者的注意事項

如果 Calendar 是， TaiwanCalendar 但不 CurrentCulture 是 "zh-華文"，則會 NativeCalendarName 傳回 GetEraName(Int32) GetAbbreviatedEraName(Int32) 空字串 ( "" ) 。