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

Автор книги: Герберт Шилдт

сообщить о нарушении

Текущая страница: 51 (всего у книги 58 страниц)

Когда пользователь определяет специальный формат, он задает этот формат в виде примера (иди изображения) того, как должны выглядеть выводимые данные. Для этой цеди используются символы, перечисленные в табл. 22.6. Они служат в качестве запол нителей и рассматриваются далее по очереди.

Символ точки обозначает местоположение десятичной точки.

Символ-заполнитель # обозначает цифровую позицию, иди разряд числа. Этот символ может указываться слева иди справа от десятичной точки либо отдельно. Так, если справа от десятичной точки указывается несколько символов #, то они обо значают количество отображаемых десятичных цифр в дробной части числа. При необходимости форматируемое числовое значение округляется. Когда же символы # указываются слева от десятичной точки, то они обозначают количество отображаемых десятичных цифр в целой части числа. При необходимости форматируемое число вое значение дополняется начальными нулями. Если целая часть числового значения состоит из большего количества цифр, чем количество указываемых символов #, то она отображается полностью, но в любом случае целая часть числового значения не усекается. В отсутствие десятичной точки наличие символа # обусловливает округле ние соответствующего целого значения. А нулевое значение, которое не существенно, например конечный нуль, не отображается. Правда, это обстоятельство несколько усложняет дело, поскольку при указании такого формата, как #.##, вообще ничего не отображается, если форматируемое числовое значение равно нулю. Для вывода нуле вого значения служит рассматриваемый далее символ-заполнитель 0.

Таблица 22.6. Символы-заполнители специального формата числовых данных Символ-заполнитель Назначение # Цифра . Десятичная точка , Разделитель групп разрядов % Процент 0 Используется для дополнения начальными и конечными нулями ; Выделяет разделы, описывающие формат для положительных, отрицательных и нулевых значений Е0 Е+0 Е-0 е0 е+0 е-0 Экспоненциальное представление чисел

Символ-заполнитель 0 обусловливает дополнение форматируемого числового зна чения начальными или конечными нулями, чтобы обеспечить минимально необхо димое количество цифр в строковом представлении данного значения. Этот символ может указываться как слева, как и справа от десятичной точки. Например, следующая строка кода: Console.WriteLine("{0:00##.#00}", 21.3);

выводит такой результат. 0021.300

Значения, состоящие из большего количества цифр, будут полностью отображать ся слева от десятичной точки, а округленные – справа.

При отображении больших числовых значений отдельные группы цифр могут от деляться друг от друга запятыми, для чего достаточно вставить запятую в шаблон, со стоящий из символов #. Например, следующая строка кода: Console.WriteLine("{0:#,###.#}", 3421.3);

выводит такой результат. 3,421.3.

Указывать запятую на каждой позиции совсем не обязательно. Если указать запя тую в шаблоне один раз, то она будет автоматически вставляться в форматируемом числовом значении через каждые три цифры слева от десятичной запятой. Например, следующая строка кода: Console.WriteLine("{0:#,###.#}", 8763421.3);

дает такой результат. 8,763,421.3.

У запятой имеется и другое назначение. Если запятая вставляется непосредственно перед десятичной точкой, то она выполняет роль масштабного коэффициента. Каж дая запятая делит форматируемое числовое значение на 1000. Например, следующая строка кода: Console.WriteLine("Значение в тысячах: {0:#,###,.#}", 8763421.3);

дает такой результат. Значение в тысячах: 8,763.4

Как показывает приведенный выше результат, числовое значение выводится мас штабированным в тысячах.

Помимо символов-заполнителей, пользовательский спецификатор формата может содержать любые другие символы, которые появляются в отформатированной строке без изменения на тех местах, где они указаны в спецификаторе формата. Например, при выполнении следующего фрагмента кода: Console.WriteLine("КПД топлива: (0:##.# миль на галлон }", 21.3);

выводится такой результат. КПД топлива: 21.3 миль на галлон

При необходимости в форматируемой строке можно также указывать такие управ ляющие последовательности, как t или n.

Символы-заполнители Е и е обусловливают отображение числовых значений в экс поненциальном представлении. В этом случае после символа Е или е должен быть указан хотя бы один нуль, хотя их может быть и больше. Нули обозначают количество отображаемых десятичных цифр. Дробная часть числового значения округляется в со ответствии с заданным форматом отображения. Если указывается символ Е, то он ото бражается прописной буквой "Е". А если указывается символ е, то он отображается строчной буквой "е". Для того чтобы знак порядка отображался всегда, используются формы Е+ или е+. А для отображения знака порядка только при выводе отрицатель ных значений служат формы Е, е, Е– или е-.

Знак ; служит разделителем в различных форматах вывода положительных, от рицательных и нулевых значений. Ниже приведена общая форма пользовательского спецификатора формата, в котором используется знак ;. положительныйформат; отрицательныйформат; нулевой_формат Рассмотрим следующий пример. Console.WriteLine(«{0:#.##; (#.##);0.00}», num);

Если значение переменной num положительно, то оно отображается с двумя раз рядами после десятичной точки. Если же значение переменной num отрицательно, то оно также отображается с двумя разрядами после десятичной точки, но в круглых скобках. А если значение переменной num равно нулю, то оно отображается в виде строки 0.00. Когда используются разделители, указывать все части приведенной выше формы пользовательского спецификатора формата совсем не обязательно. Так, если требуется вывести только положительные или отрицательные значения, нулевой формат можно опустить. (В данном случае нуль форматируется как положительное значение.) С другой стороны, можно опустить отрицательныйформат. И в этом слу чае положительныйформат и нулевойформат должны разделяться точкой с запя той. А в итоге положительный_формат будет использоваться для форматирования не только положительных, но и отрицательных значений.

В приведенном ниже примере программы демонстрируется лишь несколько спе циальных форматов, которые могут быть определены пользователем. // Пример применения специальных форматов. using System; class PictureFormatDemo { static void Main() { double num = 64354.2345; Console.WriteLine("Формат по умолчанию: " + num); // Отобразить числовое значение с 2 разрядами после десятичной точки. Console.WriteLine("Значение с 2 десятичными разрядами: " + "(0:#.##)", num); // Отобразить числовое значение с 2 разрядами после // десятичной точки и запятыми перед ней. Console.WriteLine("Добавить запятые: (0:#,###.##}", num); // Отобразить числовое значение в экспоненциальном представлении. Console.WriteLine("Использовать экспоненциальное представление: " + "{0:#.###е+00}", num); // Отобразить числовое значение, масштабированное в тысячах. Console.WriteLine("Значение в тысячах: " + "(0:#0,)", num); /* Отобразить по-разному положительные, отрицательные и нулевые значения. */ Console.WriteLine("Отобразить по-разному положительные," + "отрицательные и нулевые значения."); Console.WriteLine("{0:#.#;(#.##);0.00}", num); num = -num; Console.WriteLine("{0:#.##;(#.##);0.00}", num); num = 0.0; Console.WriteLine("{0:#.##;(#.##);0.00}", num); // Отобразить числовое значение в процентах. num = 0.17; Console.WriteLine("Отобразить в процентах: {0:#%}", num); } }

Ниже приведен результат выполнения этой программы. Формат по умолчанию: 64354.2345 Значение с 2 десятичными разрядами: 64354.23 Добавить запятые: 64,354.23 Использовать экспоненциальное представление: 6.435е+04 Значение в тысячах: 64 Отобразить по-разному положительные, отрицательные и нулевые значения. 64354.2 (64354.23) 0.00 Отобразить в процентах: 17% Форматирование даты и времени

Помимо числовых значений, форматированию нередко подлежит и другой тип данных: DateTime. Это структура, представляющая дату и время. Значения даты и времени могут отображаться самыми разными способами. Ниже приведены лишь не которые примеры их отображения. 06/05/2005 Friday, January 1, 2010 12:59:00 12:59:00 PM

Кроме того, дата и время могут быть по-разному представлены в отдельных стра нах. Для этой цели в среде .NET Framework предусмотрена обширная подсистема форматирования значений даты и времени.

Форматирование даты и времени осуществляется с помощью спецификаторов формата. Спецификаторы формата даты и времени сведены в табл. 22.7. Конкретное представление даты и времени может отличаться в силу региональных и языковых осо бенностей и поэтому зависит от настройки параметров культурной среды.

Таблица 22.7. Спецификаторы формата даты и времени Спецификатор Формат D Дата в длинной форме d Дата в краткой форме F Дата и время в длинной форме f Дата и время в краткой форме G Дата – в краткой форме, время – в длинной gg Дата и время – в краткой форме м Месяц и день m То же, что и M O Формат даты и времени, включая часовой пояс. Строка, составленная в формате O, может быть преобразована обратно в эквивалентную форму вывода даты и времени. Это так называемый “круговой” формат o То же, что и O R Дата и время в стандартной форме по Гринвичу r То же, что и R S Сортируемый формат представления даты и времени Т Время в длинной форме t Время в краткой форме U Длинная форма универсального представления даты и времени; время отображается как универсальное синхронизированное время (UTC) u Краткая форма универсального представления даты и времени Y Месяц и год y То же, что и Y

В приведенном ниже примере программы демонстрируется применение специфи каторов формата даты и времени. // Отформатировать дату и время, используя стандартные форматы. using System; class TimeAndDateFormatDemo { static void Main() { DateTime dt = DateTime.Now; // получить текущее время Console.WriteLine("Формат d: {0:d}", dt); Console.WriteLine("Формат D: {0:D}", dt); Console.WriteLine("Формат t: {0:t}", dt); Console.WriteLine("Формат T: {0:T}", dt); Console.WriteLine("Формат f: {0:f}", dt); Console.WriteLine("Формат F: {0:F}", dt); Console.WriteLine("Формат g: {0:g}", dt); Console.WriteLine("Формат G: {0:G}", dt); Console.WriteLine("Формат m: {0:m}", dt); Console.WriteLine("Формат M: {0:M}", dt); Console.WriteLine("Формат о: (0:o)", dt); Console.WriteLine("Формат O: (0:O}", dt); Console.WriteLine("Формат r: {0:r}", dt); Console.WriteLine("Формат R: {0:R}", dt); Console.WriteLine("Формат s: {0:s}", dt); Console.WriteLine("Формат u: {0:u}", dt); Console.WriteLine("Формат U: {0:U}", dt); Console.WriteLine("Формат у: {0:у}", dt); Console.WriteLine("Y format: {0:Y}", dt); } }

Эта программа дает следующий результат, который, впрочем, зависит от настроек языковых и региональных параметров локализации базового программного обеспе чения. Формат d: 2/11/2010 Формат D: Thursday, February 11, 2010 Формат t: 11:21 AM Формат T: 11:21:23 AM Формат f: Thursday, February 11, 2010 11:21 AM Формат F: Thursday, February 11, 2010 11:21:23 AM Формат g: 2/11/2010 11:21 AM Формат G: 2/11/2010 11:21:23 AM Формат m: February 11 Формат M: February 11 Формат о: 2010-02-11T11:21:23.3768153-06:00 Формат О: 2010-02-11T11:21:23.3768153-06:00 Формат r: Thu, 11 Feb 2010 11:21:23 GMT Формат R: Thu, 11 Feb 2010 11:21:23 GMT Формат s: 2010-02-11T11:21:23 Формат u: 2010-02-11 11:21:23Z Формат U: Thursday, February 11, 2010 5:21:23 PM Формат у: February, 2010 Формат Y: February, 2010

В следующем примере программы воспроизводятся очень простые часы. Время об новляется каждую секунду, и каждый час компьютер издает звонок. Для получения от форматированного строкового представления времени перед его выводом в этой про грамме используется метод ToString() из структуры DateTime. Через каждый час символ звукового предупреждающего сигнала присоединяется к отформатированной строке, представляющей время, в результате чего звенит звонок. // Пример простых часов. using System; class SimpleClock { static void Main() { string t; int seconds; DateTime dt = DateTime.Now; seconds = dt.Second; for(;;) { dt = DateTime.Now; // обновлять время через каждую секунду if (seconds != dt.Second) { seconds = dt.Second; t = dt.ToString("T"); if(dt.Minute==0 && dt.Second==0) t = t + "a"; // производить звонок через каждый час Console.WriteLine(t); } } } } Определение пользовательского формата даты и времени

Несмотря на то что стандартные спецификаторы формата даты и времени пред усмотрены практически на все случаи жизни, пользователь может определить свои собственные специальные форматы. Процесс определения пользовательских форма тов даты и времени мало чем отличается от описанного выше для числовых типов зна чений. По существу, пользователь создает пример (т.е. изображение) того, как долж ны выглядеть выводимые данные даты и времени. Для определения пользовательского формата даты и времени служат символы-заполнители, перечисленные в табл. 22.8.

Таблица 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. Вообще говоря, если один из этих спецификаторов исполь зуется в отдельности, его нужно предварить символом %.

Таблица 22.9. Символы-заполнители специального формата промежутка времени Символ-заполнитель Назначение d, dd, ddd, dddd, ddddd, dddddd, ddddddd Целые дни. Если указано несколько символов-заполнителей d, то отображается, по крайней мере, указанное количество цифр с начальными нулями, если требуется h, hh Часы (не считая тех, что составляют часть целого дня). Если указано hh, то отображаются две цифры с начальными нулями, если требуется m, mm Минуты (не считая тех, что составляют часть целого часа). Если указано mm, то отображаются две цифры с начальными нулями, если требуется s, ss Секунды (не считая тех, что составляют часть целой минуты). Если указано ss, то отображаются две цифры с начальными нулями, если требуется f, ff, fff, ffff, fffff, ffffff, fffffff Дробные доли секунды. Количество символов-заполнителей f обозначает точность представления, а остальные цифры отбрасываются F, FF, FFF, FFFF, FFFFF, FFFFFF, FFFFFFF Дробные доли секунды. Количество символов-заполнителей F обозначает точность представления, а остальные цифры отбрасываются и конечные нули не отображаются

В приведенной ниже программе демонстрируется форматирование объектов типа TimeSpan на примере отображения времени, которое приблизительно требуется для вывода на экран 1000 целых значений в цикле for. // Отформатировать объект типа TimeSpan. using System; class TimeSpanDemo { static void Main() { DateTime start = DateTime.Now; // Вывести числа от 1 до 1000. for(int i = 1; i <= 1000; i++) { Console.Write(i + " "); if((i % 10) == 0) Console.WriteLine(); } Console.WriteLine(); DateTime end = DateTime.Now; TimeSpan span = end – start; Console.WriteLine("Время выполнения: {0:c}", span); Console.WriteLine("Время выполнения: {0:g}", span); Console.WriteLine("Время выполнения: {0:G}", span); Console.WriteLine("Время выполнения: 0.{0:fff} секунды", span); } }

Выполнение этой программы приводит к следующему результату, который и в этом случае зависит от конкретных настроек языковых и региональных параметров локализации базового программного обеспечения, а также от загрузки системы за дачами и ее быстродействия. 981 982 983 984 985 986 987 988 989 990 991 992 993 994 995 996 997 998 999 1000 Время выполнения: 00:00:00.0140000 Время выполнения: 0:00:00.014 Время выполнения: 0:00:00:00.0140000 Время выполнения: 0.014 секунды Форматирование перечислений

В C# допускается также форматировать значения, определяемые в перечислении. Вообще говоря, значения из перечисления могут отображаться как по имени, так и по значению. Спецификаторы формата перечислений сведены в табл. 22.10. Обратите особое внимание на форматы G и F. Перед перечислениями, которые должны пред ставлять битовые поля, следует указывать атрибут Flags. Как правило, в битовых по лях хранятся значения, обозначающие отдельные двоичные разряды и упорядоченные по степени числа 2. При наличии атрибута Flags имена всех битовых составляющих форматируемого значения, если, конечно, это действительное значение, отображают ся с помощью спецификатора G. А с помощью спецификатора F отображаются имена всех битовых составляющих форматируемого значения, если оно составляется путем логического сложения по ИЛИ двух иди более полей, определяемых в перечислении.

Таблица 22.10. Спецификаторы формата перечислений Спецификатор Назначение D Отображает значение в виде десятичного целого числа d То же, что и D F Отображает имя значения. Если это значение можно создать путем логического сложения по ИЛИ двух или более полей, определенных в перечислении, то данный спецификатор отображает имена всех битовых составляющих заданного значения, причем независимо от того, задан атрибут Flags или нет f То же, что и F G Отображает имя значения. Если перед форматируемым перечислением указывается атрибут Flags, то данный спецификатор отображает имена всех битовых составляющих заданного значения, если, конечно, это допустимое значение g То же, что и G X Отображает значение в виде шестнадцатеричного целого числа. Для отображения как минимум восьми цифр форматируемое значение дополняется (при необходимости) начальными нулями X То же, что и X

В приведенной ниже программе демонстрируется применение спецификаторов формата перечислений. // Отформатировать перечисление. using System; class EnumFmtDemo { enum Direction { North, South, East, West } [Flags] enum Status { Ready=0x1, OffLine=0x2, Waiting=0x4, TransmitOK=0x8, ReceiveOK=0x10, OnLine=0x20 } static void Main() { Direction d = Direction.West; Console.WriteLine("{0:G}", d); Console.WriteLine("{0:F}", d); Console.WriteLine("{0:D}", d); Console.WriteLine("{0:X}", d); Status s = Status.Ready | Status.TransmitOK; Console.WriteLine("{0:G}", s); Console.WriteLine("{0:F}", s); Console.WriteLine("{0:D}", s); Console.WriteLine("{0:X}", s); } }

Ниже приведен результат выполнения этой программы. West West 3 00000003 Ready, TransmitOK Ready, TransmitOK 9 00000009