DateTimeFormatInfo.TimeSeparator DateTimeFormatInfo.TimeSeparator DateTimeFormatInfo.TimeSeparator DateTimeFormatInfo.TimeSeparator Property

定義

時刻の構成要素、つまり時間、分、および秒を区切る文字列を取得または設定します。Gets or sets the string that separates the components of time, that is, the hour, minutes, and seconds.

public:
 property System::String ^ TimeSeparator { System::String ^ get(); void set(System::String ^ value); };
public string TimeSeparator { get; set; }
member this.TimeSeparator : string with get, set
Public Property TimeSeparator As String

プロパティ値

時刻の構成要素を区切る文字列。The string that separates the components of time. InvariantInfo の既定値は、":" です。The default for InvariantInfo is ":".

例外

プロパティが null に設定されています。The property is being set to null.

このプロパティが設定されていますが、DateTimeFormatInfo オブジェクトは読み取り専用です。The property is being set and the DateTimeFormatInfo object is read-only.

次の例ではCultureInfo 、en-us カルチャのオブジェクトをインスタンス化し、その日付の区切り記号を "." に変更し、"t"、"t"、"f"、"f"、"g"、および "g" の標準書式指定文字列を使用して日付を表示します。The following example instantiates a CultureInfo object for the en-US culture, changes its date separator to ".", and displays a date by using the "t", "T", "F", "f", "G", and "g" standard format strings.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      DateTime value = new DateTime(2013, 9, 8, 14, 30, 0);
      
      string[] formats = { "t", "T", "f", "F", "G", "g" };
      CultureInfo culture = CultureInfo.CreateSpecificCulture("en-US");
      DateTimeFormatInfo dtfi = culture.DateTimeFormat;
      dtfi.TimeSeparator = ".";
      
      foreach (var fmt in formats)
         Console.WriteLine("{0}: {1}", fmt, value.ToString(fmt, dtfi));
   }
}
// The example displays the following output:
//       t: 2.30 PM
//       T: 2.30.00 PM
//       f: Sunday, September 08, 2013 2.30 PM
//       F: Sunday, September 08, 2013 2.30.00 PM
//       G: 9/8/2013 2.30.00 PM
//       g: 9/8/2013 2.30 PM
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim value As New Date(2013, 9, 8, 14, 30, 0)
      
      Dim formats() As String = { "t", "T", "f", "F", "G", "g" }
      Dim culture As CultureInfo = CultureInfo.CreateSpecificCulture("en-US")
      Dim dtfi As DateTimeFormatInfo = culture.DateTimeFormat
      dtfi.TimeSeparator = "."
      
      For Each fmt In formats
         Console.WriteLine("{0}: {1}", fmt, value.ToString(fmt, dtfi))
      Next      
   End Sub
End Module
' The example displays the following output:
'       t: 2.30 PM
'       T: 2.30.00 PM
'       f: Sunday, September 08, 2013 2.30 PM
'       F: Sunday, September 08, 2013 2.30.00 PM
'       G: 9/8/2013 2.30.00 PM
'       g: 9/8/2013 2.30 PM

注釈

カスタムパターンに ":" という書式パターンが含まDateTime.ToStringれている場合TimeSeparator 、では、書式パターンに ":" の代わりにの値が表示されます。If the custom pattern includes the format pattern ":", DateTime.ToString displays the value of TimeSeparator in place of the ":" in the format pattern.

時刻の区切り記号は、 ShortTimePatternプロパティから派生します。The time separator is derived from the ShortTimePattern property. 時刻の区切り記号は、時間区切り記号のプレースホルダーを使用するのではなく、短いまたは長い時間パターンで正確な文字列に設定することをお勧めします。We recommend that you set the time separator in short or long time patterns to an exact string instead of using the time separator placeholder. たとえば、"h-mm-ss" というパターンを取得するには、パターンを "h-mm-ss" に設定します。For example, to obtain the pattern h-mm-ss, set the pattern to "h-mm-ss". この方法では、複数の種類の区切り記号を含む "h'h ' mm m ' ss's '" (3h 36m 12s) などのパターンを設定することもできます。This practice also enables you to set patterns such as "h'h 'mm'm 'ss's'" (3h 36m 12s) that include multiple types of separators. プロパティTimeSeparatorは、書式設定操作で結果文字列の時刻の区切り記号 (":" カスタム日時書式指定子) を置き換える文字列を定義します。The TimeSeparator property defines the string that replaces the time separator (":" custom date and time format specifier) in a result string in a formatting operation. また、解析操作で時間区切り文字列を定義します。It also defines the time separator string in a parsing operation.

適用対象

こちらもご覧ください