DateTimeFormatInfo.FullDateTimePattern Property

Definition

Namespace:

System.Globalization

Assembly:

System.Runtime.dll

Source:

DateTimeFormatInfo.cs

Gets or sets the custom format string for a long date and long time value.

public:
 property System::String ^ FullDateTimePattern { System::String ^ get(); void set(System::String ^ value); };

public string FullDateTimePattern { get; set; }

member this.FullDateTimePattern : string with get, set

Public Property FullDateTimePattern As String

Property Value

String

The custom format string for a long date and long time value.

Exceptions

ArgumentNullException

The property is being set to null.

InvalidOperationException

The property is being set and the DateTimeFormatInfo object is read-only.

Examples

The following example displays the value of FullDateTimePattern for a few cultures.

using namespace System;
using namespace System::Globalization;
void PrintPattern( String^ myCulture )
{
   CultureInfo^ MyCI = gcnew CultureInfo( myCulture,false );
   DateTimeFormatInfo^ myDTFI = MyCI->DateTimeFormat;
   Console::WriteLine( " {0} {1}", myCulture, myDTFI->FullDateTimePattern );
}

int main()
{
   
   // Displays the values of the pattern properties.
   Console::WriteLine( " CULTURE    PROPERTY VALUE" );
   PrintPattern( "en-US" );
   PrintPattern( "ja-JP" );
   PrintPattern( "fr-FR" );
}

/*
This code produces the following output.  The question marks take the place of native script characters.

CULTURE    PROPERTY VALUE
en-US     dddd, MMMM dd, yyyy h:mm:ss tt
ja-JP     yyyy'年'M'月'd'日' H:mm:ss
fr-FR     dddd d MMMM yyyy HH:mm:ss

*/

using System;
using System.Globalization;

public class SamplesDTFI  {

   public static void Main()  {

      // Displays the values of the pattern properties.
      Console.WriteLine( " CULTURE    PROPERTY VALUE" );
      PrintPattern( "en-US" );
      PrintPattern( "ja-JP" );
      PrintPattern( "fr-FR" );
   }

   public static void PrintPattern( String myCulture )  {

      DateTimeFormatInfo myDTFI = new CultureInfo( myCulture, false ).DateTimeFormat;
      Console.WriteLine( "  {0}     {1}", myCulture, myDTFI.FullDateTimePattern );
   }
}

/*
This code produces the following output. Note that the exact output format depends on the OS, the OS version, and the native globalization library used by the OS.

 CULTURE    PROPERTY VALUE
  en-US     dddd, MMMM d, yyyy h:mm:ss tt
  ja-JP     yyyy年M月d日dddd H:mm:ss
  fr-FR     dddd d MMMM yyyy HH:mm:ss

*/

Imports System.Globalization

Public Class SamplesDTFI

   Public Shared Sub Main()

      ' Displays the values of the pattern properties.
      Console.WriteLine(" CULTURE    PROPERTY VALUE")
      PrintPattern("en-US")
      PrintPattern("ja-JP")
      PrintPattern("fr-FR")

   End Sub

   Public Shared Sub PrintPattern(myCulture As [String])

      Dim myDTFI As DateTimeFormatInfo = New CultureInfo(myCulture, False).DateTimeFormat
      Console.WriteLine("  {0}     {1}", myCulture, myDTFI.FullDateTimePattern)

   End Sub

End Class

'This code produces the following output.  The question marks take the place of native script characters.
'
' CULTURE    PROPERTY VALUE
'  en-US     dddd, MMMM dd, yyyy h:mm:ss tt
'  ja-JP     yyyy'年'M'月'd'日' H:mm:ss
'  fr-FR     dddd d MMMM yyyy HH:mm:ss
'

Remarks

The "F" standard format string is an alias for the FullDateTimePattern property. In other words, the custom format string assigned to this property defines the format of the result string for the "F" standard format string. For more information, see Standard Date and Time Format Strings.

The value of the FullDateTimePattern property is generated dynamically by concatenating the LongDatePattern and LongTimePattern properties separated by a space. This dynamic assignment occurs under the following conditions:

• If the property value is retrieved before it has been explicitly set.
• When the value of the LongDatePattern property changes.
• When the value of the LongTimePattern property changes.

This property is affected if the value of the Calendar property changes.

See also

• Standard Date and Time Format Strings
• Custom Date and Time Format Strings