Export (0) Print
Expand All

DateTimeFormatInfo.ShortestDayNames Property

Updated: June 2010

Gets or sets a string array of the shortest unique abbreviated day names associated with the current DateTimeFormatInfo object.

Namespace:  System.Globalization
Assembly:  mscorlib (in mscorlib.dll)

'Declaration
<ComVisibleAttribute(False)> _
Public Property ShortestDayNames As String()

Property Value

Type: System.String()
A string array of day names.

ExceptionCondition
ArgumentException

In a set operation, the array does not have exactly seven elements.

ArgumentNullException

In a set operation, the value array or one of the elements of the value array is Nothing.

InvalidOperationException

In a set operation, the current DateTimeFormatInfo object is read-only.

The following example demonstrates several methods and properties that specify date and time format patterns, native calendar name, and full and abbreviated month and day names.


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

Imports System
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 'Main
End Class 'Sample

'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" 
'

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

.NET for Windows Store apps

Supported in: Windows 8

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone Silverlight 8.1, Windows Phone Silverlight 8

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Date

History

Reason

June 2010

Added exception information.

Content bug fix.

Show:
© 2014 Microsoft