d |
Представляет день месяца в виде числа от 1 до 31. Одноразрядные числа форматируются без нуля в начале. Дополнительные сведения об использовании одиночных описателей настраиваемых форматов см. в разделе Использование единичных описателей настраиваемых форматов.
В следующем примере описатель настраиваемого формата d используется в нескольких строках формата.
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15);
Console.WriteLine(date1.ToString("d, M",
CultureInfo.InvariantCulture));
// Displays 29, 8
Console.WriteLine(date1.ToString("d MMMM",
CultureInfo.CreateSpecificCulture("en-US")));
// Displays 29 August
Console.WriteLine(date1.ToString("d MMMM",
CultureInfo.CreateSpecificCulture("es-MX")));
// Displays 29 agosto
|
dd |
Представляет день месяца в виде числа от 01 до 31. Одноразрядные числа форматируются с нулем в начале. В следующем примере описатель настраиваемого формата dd используется в строке настраиваемого формата.
|
ddd |
Представляет сокращенное название дня недели согласно текущему значению свойства DateTimeFormatInfo.AbbreviatedDayNames. В следующем примере описатель настраиваемого формата ddd используется в строке настраиваемого формата.
|
dddd (и любое число добавочных описателей d) |
Представляет полное название дня недели согласно текущему значению свойства DateTimeFormatInfo.DayNames. В следующем примере описатель настраиваемого формата dddd используется в строке настраиваемого формата.
|
f |
Представляет наиболее значимую цифру секунд, то есть десятые доли секунды в значении даты и времени.
Если описатель формата f используется без других описателей формата, то он интерпретируется как описатель f стандартного формата даты и времени. Дополнительные сведения об использовании единичных описателей форматов см. в разделе Использование единичных описателей настраиваемых форматов.
При использовании в составе строки формата, передаваемой методу ParseExact, TryParseExact, ParseExact или TryParseExact, число используемых описателей формата f указывает на число наиболее значимых цифр секунд, которые должны присутствовать для обеспечения успешного разбора строки.
В следующем примере описатель настраиваемого формата f используется в строке настраиваемого формата.
Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018
|
ff |
Представляет две наиболее значимые цифры секунд, то есть сотые доли секунды в значении даты и времени. В следующем примере описатель настраиваемого формата ff используется в строке настраиваемого формата.
Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018
|
fff |
Представляет три наиболее значимые цифры секунд, то есть миллисекунды в значении даты и времени. В следующем примере описатель настраиваемого формата fff используется в строке настраиваемого формата.
Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018
|
ffff |
Представляет четыре наиболее значимые цифры секунд, то есть десятитысячные доли секунды в значении даты и времени.
Хотя существует возможность отображения десятитысячных долей секунды, это значение может не иметь смысла. Точность значений даты и времени зависит от разрешения системных часов. В операционной системе Windows NT 3.5 и более поздних версиях, равно как и в Windows Vista, разрешение часов приблизительно соответствует 10-15 миллисекундам. |
fffff |
Представляет пять наиболее значимых цифр секунд, то есть стотысячные доли секунды в значении даты и времени.
Хотя существует возможность отображения стотысячных долей секунды в значении времени, это значение может не иметь смысла. Точность значений даты и времени зависит от разрешения системных часов. В операционной системе Windows NT 3.5 и более поздних версиях, равно как и в Windows Vista, разрешение часов приблизительно соответствует 10-15 миллисекундам. |
ffffff |
Представляет шесть наиболее значимых цифр секунд, то есть миллионные доли секунды в значении даты и времени.
Хотя существует возможность отображения миллионных долей секунды, это значение может не иметь смысла. Точность значений даты и времени зависит от разрешения системных часов. В операционной системе Windows NT 3.5 и более поздних версиях, равно как и в Windows Vista, разрешение часов приблизительно соответствует 10-15 миллисекундам. |
fffffff |
Представляет семь наиболее значимых цифр секунд, то есть десятимиллионные доли секунды в значении даты и времени.
Хотя существует возможность отображения десятимиллионных долей секунды, это значение может не иметь смысла. Точность значений даты и времени зависит от разрешения системных часов. В операционной системе Windows NT 3.5 и более поздних версиях, равно как и в Windows Vista, разрешение часов приблизительно соответствует 10-15 миллисекундам. |
F |
Представляет наиболее значимую цифру секунд, то есть десятые доли секунды в значении даты и времени. Если цифра равна нулю, то ничего не отображается.
Если описатель формата F используется без других описателей формата, то он интерпретируется как описатель F стандартного формата даты и времени. Дополнительные сведения об использовании единичных описателей форматов см. в разделе Использование единичных описателей настраиваемых форматов.
Число описателей формата F, используемых с методом ParseExact, TryParseExact, ParseExact или с TryParseExact, задает максимальное количество наиболее значимых цифр секунд, которые должны присутствовать для успешного разбора строки.
В следующем примере описатель настраиваемого формата F используется в строке настраиваемого формата.
Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018
|
FF |
Представляет две наиболее значимые цифры секунд, то есть сотые доли секунды в значении даты и времени. При этом нули в конце или два нуля не отображаются. В следующем примере описатель настраиваемого формата FF используется в строке настраиваемого формата.
Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018
|
FFF |
Представляет три наиболее значимые цифры секунд, то есть миллисекунды в значении даты и времени. При этом нули в конце или три нуля не отображаются. В следующем примере описатель настраиваемого формата FFF используется в строке настраиваемого формата.
Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018
|
FFFF |
Представляет четыре наиболее значимые цифры секунд, то есть десятитысячные доли секунды в значении даты и времени. При этом нули в конце или четыре нуля не отображаются.
Хотя существует возможность отображения десятитысячных долей секунды, это значение может не иметь смысла. Точность значений даты и времени зависит от разрешения системных часов. В операционной системе Windows NT 3.5 и более поздних версиях, равно как и в Windows Vista, разрешение часов приблизительно соответствует 10-15 миллисекундам. |
FFFFF |
Представляет пять наиболее значимых цифр секунд, то есть стотысячные доли секунды в значении даты и времени. При этом нули в конце или пять нулей не отображаются.
Хотя существует возможность отображения стотысячных долей секунды в значении времени, это значение может не иметь смысла. Точность значений даты и времени зависит от разрешения системных часов. В операционной системе Windows NT 3.5 и более поздних версиях, равно как и в Windows Vista, разрешение часов приблизительно соответствует 10-15 миллисекундам. |
FFFFFF |
Представляет шесть наиболее значимых цифр секунд, то есть миллионные доли секунды в значении даты и времени. При этом нули в конце или шесть нулей не отображаются.
Хотя существует возможность отображения миллионных долей секунды, это значение может не иметь смысла. Точность значений даты и времени зависит от разрешения системных часов. В операционной системе Windows NT 3.5 и более поздних версиях, равно как и в Windows Vista, разрешение часов приблизительно соответствует 10-15 миллисекундам. |
FFFFFFF |
Представляет семь наиболее значимых цифр секунд, то есть десятимиллионные доли секунды в значении даты и времени. При этом нули в конце или семь нулей не отображаются.
Хотя существует возможность отображения десятимиллионных долей секунды, это значение может не иметь смысла. Точность значений даты и времени зависит от разрешения системных часов. В операционной системе Windows NT 3.5 и более поздних версиях, равно как и в Windows Vista, разрешение часов приблизительно соответствует 10-15 миллисекундам. |
g, gg (и любое число дополнительных описателей g) |
Представляет период или эру (например, "н. э."). Этот шаблон не учитывается при форматировании, если форматируемой дате не сопоставлена строка периода или эры. Дополнительные сведения об использовании единичных описателей форматов см. в разделе Использование единичных описателей настраиваемых форматов.
В следующем примере описатель настраиваемого формата g используется в строке настраиваемого формата.
|
h |
Представляет часы числом от 1 до 12, то есть в 12-часовом виде, в котором полные часы отсчитываются от полуночи или от полудня. Час после полуночи неотличим от того же часа после полудня. Часы не округляются, и часы с одной цифрой форматируются без нуля в начале. Например, для заданного времени 5:43 этот описатель настраиваемого формата выведет "5". Дополнительные сведения об использовании единичных описателей форматов см. в разделе Использование единичных описателей настраиваемых форматов.
В следующем примере описатель настраиваемого формата h используется в строке настраиваемого формата.
Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1.5
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1.5
|
hh, hh (и любое число дополнительных описателей h) |
Представляет часы числом от 01 до 12, т. е. в 12-часовом виде, в котором часы отсчитываются от полуночи или от полудня. Час после полуночи неотличим от того же часа после полудня. Часы не округляются, и часы с одной цифрой форматируются с нулем в начале. Например, для заданного времени 5:43 этот описатель настраиваемого формата выведет "05".
В следующем примере описатель настраиваемого формата hh используется в строке настраиваемого формата.
Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01 du.
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01.50 du.
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01 du.
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01.50 du.
|
H |
Представляет часы числом от 0 до 23, т. е. в 24-часовом виде, в котором часы отсчитываются от полуночи, начиная с нуля. Часы с одной цифрой форматируются без нуля в начале.
Дополнительные сведения об использовании единичных описателей форматов см. в разделе Использование единичных описателей настраиваемых форматов.
В следующем примере описатель настраиваемого формата H используется в строке настраиваемого формата.
|
HH, HH (и любое число дополнительных описателей H) |
Представляет часы числом от 00 до 23, т. е. в 24-часовом виде, в котором часы отсчитываются от полуночи, начиная с нуля. Часы с одной цифрой форматируются с нулем в начале. В следующем примере описатель настраиваемого формата HH используется в строке настраиваемого формата.
|
K |
Представляет сведения о часовом поясе для значений даты и времени. При использовании со значениями DateTime результирующая строка определяется значением свойства DateTime.Kind. Для местного часового пояса (значение свойства DateTime.Kind равно DateTimeKind.Local) этот описатель эквивалентен описателю zzz и выдает результирующую строку, содержащую локальное смещение от универсального синхронизированного времени (UTC); например, "–07:00". Для времени UTC (значение свойства DateTime.Kind равно DateTimeKind.Utc) результирующая строка содержит знак "Z" для представления даты в формате UTC. Для времени в неопределенном часовом поясе (значение времени, свойство DateTime.Kind которого равно DateTimeKind.Unspecified) результат эквивалентен String.Empty. Для значений DateTimeOffset описатель формата K эквивалентен описателю формата zz, который выдает результирующую строку, содержащую смещение значения от времени UTC в виде DateTimeOffset.
Дополнительные сведения об использовании единичных описателей форматов см. в разделе Использование единичных описателей настраиваемых форматов.
В следующем примере показаны строки, полученные с использованием описателя настраиваемого формата K с различными значениями DateTime и DateTimeOffset в тихоокеанском стандартном часовом поясе США.
Console.WriteLine(Date.Now.ToString("%K"))
' Displays -07:00
Console.WriteLine(Date.UtcNow.ToString("%K"))
' Displays Z
Console.WriteLine("'{0}'", _
Date.SpecifyKind(Date.Now, _
DateTimeKind.Unspecified). _
ToString("%K"))
' Displays ''
Console.WriteLine(DateTimeOffset.Now.ToString("%K"))
' Displays -07:00
Console.WriteLine(DateTimeOffset.UtcNow.ToString("%K"))
' Displays +00:00
Console.WriteLine(New DateTimeOffset(2008, 5, 1, 6, 30, 0, _
New TimeSpan(5, 0, 0)). _
ToString("%K"))
' Displays +05:00
Console.WriteLine(DateTime.Now.ToString("%K"));
// Displays -07:00
Console.WriteLine(DateTime.UtcNow.ToString("%K"));
// Displays Z
Console.WriteLine("'{0}'",
DateTime.SpecifyKind(DateTime.Now,
DateTimeKind.Unspecified).ToString("%K"));
// Displays ''
Console.WriteLine(DateTimeOffset.Now.ToString("%K"));
// Displays -07:00
Console.WriteLine(DateTimeOffset.UtcNow.ToString("%K"));
// Displays +00:00
Console.WriteLine(new DateTimeOffset(2008, 5, 1, 6, 30, 0,
new TimeSpan(5, 0, 0)).ToString("%K"));
// Displays +05:00
|
m |
Представляет минуты как число от 0 до 59. Значение представляет собой количество целых минут, прошедших за последний час. Минуты с одной цифрой форматируются без нуля в начале. Дополнительные сведения об использовании единичных описателей форматов см. в разделе Использование единичных описателей настраиваемых форматов. В следующем примере описатель настраиваемого формата m используется в строке настраиваемого формата.
Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1.5
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1.5
|
mm, mm (и любое число дополнительных описателей m) |
Представляет минуты как число от 00 до 59. Значение представляет собой количество целых минут, прошедших за последний час. Минуты с одной цифрой форматируются с нулем в начале. В следующем примере описатель настраиваемого формата mm используется в строке настраиваемого формата.
Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01 du.
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01.50 du.
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01 du.
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01.50 du.
|
M |
Представляет месяц как число от 1 до 12. Месяц с одной цифрой форматируется без нуля в начале. Дополнительные сведения об использовании единичных описателей форматов см. в разделе Использование единичных описателей настраиваемых форматов. В следующем примере описатель настраиваемого формата M используется в строке настраиваемого формата.
DateTime date1 = new DateTime(2008, 8, 18);
Console.WriteLine(date1.ToString("(M) MMM, MMMM",
CultureInfo.CreateSpecificCulture("en-US")));
// Displays (8) Aug, August
Console.WriteLine(date1.ToString("(M) MMM, MMMM",
CultureInfo.CreateSpecificCulture("nl-NL")));
// Displays (8) aug, augustus
Console.WriteLine(date1.ToString("(M) MMM, MMMM",
CultureInfo.CreateSpecificCulture("lv-LV")));
// Displays (8) Aug, augusts
|
MM |
Представляет месяц как число от 01 до 12. Месяц с одной цифрой форматируется с нулем в начале. В следующем примере описатель настраиваемого формата MM используется в строке настраиваемого формата.
|
MMM |
Представляет сокращенное название месяца согласно текущему значению свойства DateTimeFormatInfo.AbbreviatedMonthNames. В следующем примере описатель настраиваемого формата MMM используется в строке настраиваемого формата.
|
MMMM |
Представляет полное название месяца согласно текущему значению свойства DateTimeFormatInfo.MonthNames. В следующем примере описатель настраиваемого формата MMMM используется в строке настраиваемого формата.
|
s |
Представляет секунды как число от 0 до 59. Результат представляет количество целых секунд, прошедших за последнюю минуту. Секунды с одной цифрой форматируются без нуля в начале. Дополнительные сведения об использовании единичных описателей форматов см. в разделе Использование единичных описателей настраиваемых форматов. В следующем примере описатель настраиваемого формата s используется в строке настраиваемого формата.
Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1.5
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1.5
|
ss, ss (и любое число дополнительных описателей s) |
Представляет секунды как число от 00 до 59. Результат представляет количество целых секунд, прошедших за последнюю минуту. Секунды с одной цифрой форматируются с нулем в начале. В следующем примере описатель настраиваемого формата ss используется в строке настраиваемого формата.
Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01 du.
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01.50 du.
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01 du.
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01.50 du.
|
t |
Представляет первый знак обозначения AM/PM, определяемый текущим значением свойства DateTimeFormatInfo.AMDesignator или DateTimeFormatInfo.PMDesignator. Обозначение AM используется, если значение форматируемого часа меньше 12. В противном случае используется обозначение PM. Дополнительные сведения об использовании единичных описателей форматов см. в разделе Использование единичных описателей настраиваемых форматов.
В следующем примере описатель настраиваемого формата t используется в строке настраиваемого формата.
Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1.5
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1.5
|
tt, tt (и любое число дополнительных описателей t) |
Представляет обозначение AM/PM в соответствии с текущим значением свойства DateTimeFormatInfo.AMDesignator или DateTimeFormatInfo.PMDesignator. Обозначение AM используется, если значение форматируемого часа меньше 12. В противном случае используется обозначение PM.
Приложение должно использовать описатель tt в тех языках, в которых требуется гарантировать различие между обозначениями AM и PM. Например, это японский язык, в котором обозначения AM и PM отличаются вторым знаком, а не первым.
В следующем примере описатель настраиваемого формата tt используется в строке настраиваемого формата.
Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01 du.
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01.50 du.
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01 du.
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01.50 du.
|
y |
Представляет год как число из одной или двух цифр. Если год имеет более двух цифр, то в результате отображаются только две младшие цифры. Если первая цифра двузначного года начинается с нуля (например, 2008), то число форматируется без нуля в начале. Дополнительные сведения об использовании единичных описателей форматов см. в разделе Использование единичных описателей настраиваемых форматов.
В следующем примере описатель настраиваемого формата y используется в строке настраиваемого формата.
|
yy |
Представляет год как число из двух цифр. Если год имеет более двух цифр, то в результате отображаются только две младшие цифры. Если двузначное обозначение года имеет менее двух значащих цифр, то число дополняется стоящими в начале нулями до двух цифр.
В следующем примере описатель настраиваемого формата yy используется в строке настраиваемого формата.
|
yyy |
Представляет год как число не менее чем c тремя цифрами. Если в году больше трех значащих цифр, то они включаются в результат. Если в году меньше трех цифр, то число дополняется стоящими в начале нулями до трех цифр.
Обратите внимание, что для тайского буддистского календаря, в котором в году может быть пять цифр, этот описатель формата отображает все пять цифр.
В следующем примере описатель настраиваемого формата yyy используется в строке настраиваемого формата.
|
yyyy |
Представляет год как четырехзначное число. Если в году больше четырех цифр, то в результате отображаются только четыре младшие цифры. Если в году меньше четырех цифр, то число дополняется стоящими в начале нулями до достижения четырех цифр.
Обратите внимание, что для тайского буддистского календаря, в котором в году может быть пять цифр, этот описатель формата отображает все пять цифр.
В следующем примере описатель настраиваемого формата yyyy используется в строке настраиваемого формата.
|
yyyyy (и любое число дополнительных описателей y) |
Представляет год как пятизначное число. Если в году больше пяти цифр, то в результате отображаются только пять младших цифр. Если в году меньше пяти цифр, то число дополняется стоящими в начале нулями до пяти цифр.
Если имеются дополнительные описатели y, то при необходимости достижения количества заданных описателей у число дополняется нулями в начале.
В следующем примере описатель настраиваемого формата yyyyy используется в строке настраиваемого формата.
|
z |
Вместе со значениями DateTime представляет знаковое смещение местного часового пояса операционной системы от времени UTC, измеренное в часах. Описатель не отражает значение свойства Kind экземпляра. По этой причине описатель формата z не рекомендуется использовать со значениями DateTime.
Для значений DateTimeOffset он представляет смещение значения DateTimeOffset в часах от времени UTC.
Смещение всегда отображается со знаком в начале. Плюс (+) указывает на то, что часы опережают время UTC, а минус (–) — на то, что они от него отстают. Смещение принимает значения от –12 до +13. Смещение с одной цифрой форматируется без нуля в начале. Дополнительные сведения об использовании единичных описателей форматов см. в разделе Использование единичных описателей настраиваемых форматов. В следующем примере описатель настраиваемого формата z используется в строке настраиваемого формата.
Dim date1 As Date = Date.UtcNow
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
date1))
' Displays -7, -07, -07:00
Dim date2 As New DateTimeOffset(2008, 8, 1, 0, 0, 0, _
New Timespan(6, 0, 0))
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
date2))
' Displays +6, +06, +06:00
DateTime date1 = DateTime.UtcNow;
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}",
date1));
// Displays -7, -07, -07:00
DateTimeOffset date2 = new DateTimeOffset(2008, 8, 1, 0, 0, 0,
new TimeSpan(6, 0, 0));
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}",
date2));
// Displays +6, +06, +06:00
|
zz |
Вместе со значениями DateTime представляет знаковое смещение местного часового пояса операционной системы от времени UTC, измеряемое в часах. Описатель не отражает значение свойства Kind экземпляра. По этой причине описатель формата zz не рекомендуется использовать со значениями DateTime.
Для значений DateTimeOffset он представляет смещение значения DateTimeOffset в часах от времени UTC.
Смещение всегда отображается со знаком в начале. Плюс (+) указывает на то, что часы опережают время UTC, а минус (–) — на то, что они от него отстают. Смещение принимает значения от –12 до +13. Смещение с одной цифрой форматируется c нулем в начале. В следующем примере описатель настраиваемого формата zz используется в строке настраиваемого формата.
Dim date1 As Date = Date.UtcNow
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
date1))
' Displays -7, -07, -07:00
Dim date2 As New DateTimeOffset(2008, 8, 1, 0, 0, 0, _
New Timespan(6, 0, 0))
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
date2))
' Displays +6, +06, +06:00
DateTime date1 = DateTime.UtcNow;
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}",
date1));
// Displays -7, -07, -07:00
DateTimeOffset date2 = new DateTimeOffset(2008, 8, 1, 0, 0, 0,
new TimeSpan(6, 0, 0));
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}",
date2));
// Displays +6, +06, +06:00
|
zzz, zzz (и любое число дополнительных описателей z) |
Вместе со значениями DateTime представляет знаковое смещение местного часового пояса операционной системы от времени UTC, измеряемое в часах и минутах. Описатель не отражает значение свойства Kind экземпляра. По этой причине описатель формата zzz не рекомендуется использовать со значениями DateTime.
Для значений DateTimeOffset он представляет смещение значения DateTimeOffset в часах и минутах от времени UTC.
Смещение всегда отображается со знаком в начале. Плюс (+) указывает на то, что часы опережают время UTC, а минус (–) — на то, что они от него отстают. Смещение принимает значения от –12 до +13. Смещение с одной цифрой форматируется c нулем в начале. В следующем примере описатель настраиваемого формата zzz используется в строке настраиваемого формата.
Dim date1 As Date = Date.UtcNow
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
date1))
' Displays -7, -07, -07:00
Dim date2 As New DateTimeOffset(2008, 8, 1, 0, 0, 0, _
New Timespan(6, 0, 0))
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
date2))
' Displays +6, +06, +06:00
DateTime date1 = DateTime.UtcNow;
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}",
date1));
// Displays -7, -07, -07:00
DateTimeOffset date2 = new DateTimeOffset(2008, 8, 1, 0, 0, 0,
new TimeSpan(6, 0, 0));
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}",
date2));
// Displays +6, +06, +06:00
|
: |
Представляет разделитель времени, определяемый текущим свойством DateTimeFormatInfo.TimeSeparator. Этот разделитель используется для разделения часов, минут и секунд. |
/ |
Представляет разделитель даты, определяемый текущим свойством DateTimeFormatInfo.DateSeparator. Этот разделитель используется для разделения лет, месяцев и дней. |
" |
Представляет строку в кавычках (знак кавычки). Отображает значение любой строки между двух кавычек ("). В приложении всем кавычкам должен предшествовать escape-знак ("\"). |
' |
Представляет строку в одиночных кавычках (апострофах). Отображает значение строки между двух одинарных кавычек ('). |
%c |
Представляет результат, соответствующий описателю настраиваемого формата c, если строка настраиваемого формата даты и времени состоит исключительно из этого описателя настраиваемого формата. Чтобы использовать описатели настраиваемого формата "d", "f", "F", "h", "m", "s", "t", "y", "z", "H" или "M" по отдельности, в приложении следует указывать "%d", "%f", "%F", "%h", "%m", "%s", "%t", "%y", "%z", "%H" или "%M". Дополнительные сведения об использовании единичных описателей форматов см. в разделе Использование единичных описателей настраиваемых форматов. |
\c |
Представляет escape-знак и отображает знак "c" в качестве литерала, когда этому знаку предшествует escape-знак ("\"). Для вставки знака обратной косой черты в выходную строку приложение должно использовать два escape-знака ("\\"). |
Любой другой знак |
Копирует любой другой знак в выходную строку, не влияя на форматирование. |