Форматирующие строки. Пользовательский формат числовых данных. Встроенные форматы числовых данных

Форматирующие строки

Если вы хотите, чтобы разрабатываемые классы были дружественными к пользователю, они должны предлагать средства для отображения своих строковых представлений в любом из форматов, которые могут понадобиться пользователю. В исполняющей среде.NET определен стандартный способ достижения этого - интерфейс IFormattable. Описание способа добавления этого важного свойства к пользовательским классам и структурам и представляет собой тему настоящей статьи.

Начнем с рассмотрения того, что происходит, когда форматная строка применяется к примитивному типу, а отсюда станет ясно, как следует включать спецификаторы формата для пользовательских классов и структур:

Decimal d = 12.05667m; int i = 5; Console.WriteLine("Значение переменной d = {0:C}, а i = {1}",d,i);

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

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

Спецификатор формата предваряется двоеточием. Это указывает, каким образом необходимо отформатировать элемент. Например, можно указать, должно ли число быть форматировано как денежное значение, либо его следует отобразить в научной нотации.

В открывшемся списке выберите нужную папку и щелкните на ней мышью. В строке Имя файла удалите имя и впишите новое имя файла. При повторном сохранении файла. Для создания и редактирования документа «Обычный режим» предоставляет самый «большой» экран и отображает форматирование символов и абзацев. Если вы захотите отобразить специальные символы форматирования, то в обычном режиме их также можно увидеть.

Режим «Структура» предназначен для работы с большими документами или документами, состоящими из нескольких файлов. В режиме структуры можно увидеть структуру документа в свернутом и развернутом виде. Режим структуры отображает структуру документа и ровно столько содержимого документа, сколько вам нужно. Щелкнув номера заголовков или знаки «плюс» и «минус» на панели инструментов Структура, можно отобразить содержимое документа более или менее подробно. Содержимое документа не изменяется, но оно не полностью отображается на экране.

В следующей таблице перечислены часто используемые спецификаторы формата для числовых типов:

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

Форматирование даты и времени

Помимо числовых значений, форматированию нередко подлежит и другой тип данных: DateTime. Это структура, представляющая дату и время. Значения даты и времени могут отображаться самыми разными способами.

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

В приведенном ниже примере программы демонстрируется применение спецификаторов формата даты и времени.

This example formats double to string with fixed number of decimal places . For two decimal places use pattern „0.00 “. If a float number has less decimal places, the rest digits on the right will be zeroes. If it has more decimal places, the number will be rounded.

// just two decimal places String .Format("{0:0.00}" , 123.4567); // "123.46" String .Format("{0:0.00}" , 123.4); // "123.40" String .Format("{0:0.00}" , 123.0); // "123.00"

Next example formats double to string with floating number of decimal places . E.g. for maximal two decimal places use pattern „0.## “.

// max. two decimal places String .Format("{0:0.##}" , 123.4567); // "123.46" String .Format("{0:0.##}" , 123.4); // "123.4" String .Format("{0:0.##}" , 123.0); // "123"

Digits before decimal point

If you want a float number to have any minimal number of digits before decimal point use N-times zero before decimal point. E.g. pattern „00.0 “ formats a float number to string with at least two digits before decimal point and one digit after that.

// at least two digits before decimal point String .Format("{0:00.0}" , 123.4567); // "123.5" String .Format("{0:00.0}" , 23.4567); // "23.5" String .Format("{0:00.0}" , 3.4567); // "03.5" String .Format("{0:00.0}" , -3.4567); // "-03.5"

Thousands separator

To format double to string with use of thousands separator use zero and comma separator before an usual float formatting pattern, e.g. pattern „0,0.0 “ formats the number to use thousands separators and to have one decimal place.

String .Format("{0:0,0.0}" , 12345.67); // "12,345.7" String .Format("{0:0,0}" , 12345.67); // "12,346"

Zero

Float numbers between zero and one can be formatted in two ways, with or without leading zero before decimal point. To format number without a leading zero use # before point. For example „#.0 “ formats number to have one decimal place and zero to N digits before decimal point (e.g. „.5“ or „123.5“).

Following code shows how can be formatted a zero (of double type).

String .Format("{0:0.0}" , 0.0); // "0.0" String .Format("{0:0.#}" , 0.0); // "0" String .Format("{0:#.0}" , 0.0); // ".0" String .Format("{0:#.#}" , 0.0); // ""

Align numbers with spaces

To align float number to the right use comma „, “ option before the colon. Type comma followed by a number of spaces, e.g. „0,10:0.0 “ (this can be used only in String.Format method, not in double.ToString method). To align numbers to the left use negative number of spaces.

String .Format("{0,10:0.0}" , 123.4567); // " 123.5" String .Format("{0,-10:0.0}" , 123.4567); // "123.5 " String .Format("{0,10:0.0}" , -123.4567); // " -123.5" String .Format("{0,-10:0.0}" , -123.4567); // "-123.5 "

Custom formatting for negative numbers and zero

If you need to use custom format for negative float numbers or zero, use semicolon separator „; “ to split pattern to three sections . The first section formats positive numbers, the second section formats negative numbers and the third section formats zero. If you omit the last section, zero will be formatted using the first section.

String .Format("{0:0.00;minus 0.00;zero}" , 123.4567); // "123.46" String .Format("{0:0.00;minus 0.00;zero}" , -123.4567); // "minus 123.46" String .Format("{0:0.00;minus 0.00;zero}" , 0.0); // "zero"

Some funny examples

As you could notice in the previous example, you can put any text into formatting pattern, e.g. before an usual pattern „my text 0.0 “. You can even put any text between the zeroes, e.g. „0aaa .bbb 0 “.

String .Format("{0:my number is 0.0}" , 12.3); // "my number is 12.3" String .Format("{0:0aaa.bbb0}" , 12.3); // "12aaa.bbb3"