Полное руководство. С# 4.0

Таблица 22.8. Символы-заполнители специального формата даты и времени

Символ-заполнитель

Назначение

d День месяца в виде числа в пределах от 1 до 31 dd День месяца в виде числа в пределах от 1 до 31. Числовые значения в пределах от 1 до 9 дополняются начальным нулем ddd Сокращенное название дня недели dddd Полное название дня недели f, ff, fff, ffff, fffff, ffffff, fffffff Дробная часть числового значения, обозначающего секунды. Количество десятичных разрядов определяется числом заданных символов f g Эра h Часы в виде числа в пределах от 1 до 12 hh Часы в виде числа в пределах от 1 до 12. Числовые значения в пределах от 1 до 9 дополняются начальным нулем H Часы в виде числа в пределах от 0 до 23 HH Часы в виде числа в пределах от 0 до 23. Числовые значения в пределах от 1 до 9 дополняются начальным нулем К Часовой пояс, указываемый в часах. Для автоматической коррекции местного времени и универсального синхронизированного времени (UTC) используется значение свойства DateTime.Kind. (Этот спецификатор формата рекомендуется теперь вместо спецификаторов с символамизаполнителями Z.) m Минуты mm Минуты. Числовые значения в пределах от 1 до 9 дополняются начальным нулем M Месяц в виде числа в пределах от 1 до 12 MM Месяц в виде числа в пределах от 1 до 12. Числовые значе ния в пределах от 1 до 9 дополняются начальным нулем МММ Сокращенное название месяца MMMM Полное название месяца s Секунды ss Секунды. Числовые значения в пределах от 1 до 9 дополняются начальным нулем t Символ "А” или “Р”, обозначающий время А.М. (до полудня) или P.M. (после полудня) соответственно tt A.M. или P.M. У Год в виде двух цифр, если недостаточно одной УУ Год в виде двух цифр. Числовые значения в пределах от 1 до 9 дополняются начальным нулем УУУ Год в виде трех цифр УУУУ Год в виде четырех цифр УУУУУ Год в виде пяти цифр z Смещение часового пояса в часах zz Смещение часового пояса в часах. Числовые значения в пределах от 1 до 9 дополняются начальным нулем zzz Смещение часового пояса в часах и минутах : Разделитель для составляющих значения времени / Разделитель для составляющих значения даты %fmt Стандартный формат, соответствующий спецификатору формата fmt

Глядя на табл. 22.8, можно заметить, что символы-заполнители d, f, g, m, M, s и t выполняют ту же функцию, что и аналогичные символы-заполнители из табл. 22.7. Вообще говоря, если один из этих символов указывается отдельно, то он интерпре тируется как спецификатор формата. В противном случае он считается символом- заполнителем. Поэтому если требуется указать несколько таких символов отдельно, но интерпретировать их как символы-заполнители, то перед каждым из них следует поставить знак %.

В приведенном ниже примере программы демонстрируется применение несколь ких форматов даты и времени. // Отформатировать дату и время, используя специальные форматы. using System; class CustomTimeAndDateFormatsDemo { static void Main { DateTime dt = DateTime.Now; Console.WriteLine("Время: {0:hh:mm tt}", dt); Console.WriteLine("Время в 24-часовом формате: {0:HH:mm}", dt); Console.WriteLine("Дата: {0:ddd МММ dd, yyyy}", dt); Console.WriteLine("Эра: {0:gg}", dt); Console.WriteLine("Время в секундах: " + "{0:HH:mm:ss tt}", dt); Console.WriteLine("День месяца в формате m: {0:m}", dt); Console.WriteLine("Минуты в формате m: {0:%m}", dt); } }

Вот к какому результату приводит выполнение этой программы (опять же все за висит от конкретных настроек языковых и региональных параметров локализации ба зового программного обеспечения). Время: 11:19 AM Время 24-часовом формате: 11:19 Дата: Thu Feb 11, 2010 Эра: A.D. Время в секундах: 11:19:40 AM День месяца в формате m: February 11 Минуты в формате т: 19 Форматирование промежутков времени

Начиная с версии 4.0, в среде .NET Framework появилась возможность формати ровать объекты типа TimeSpan — структуры, представляющей промежуток времени. Объект типа TimeSpan может быть получен самыми разными способами, в том числе и в результате вычитания одного объекта типа DateTime из другого. И хотя формати ровать объекты типа TimeSpan приходится нечасто, о такой возможности все же стоит упомянуть вкратце.

По умолчанию в структуре TimeSpan поддерживаются три стандартных специ фикатора формата даты и времени: с, g и G. Они обозначают инвариантную форму промежутка времени, короткую и длинную форму с учетом культурной среды соот ветственно (последняя форма всегда включает в себя дни). Кроме того, в структуре TimeSpan поддерживаются специальные спецификаторы формата даты и времени, приведенные в табл. 22.9. Вообще говоря, если один из этих спецификаторов исполь зуется в отдельности, его нужно предварить символом %.