Строки форматирования в .NET

Источник: www.jenyay.net  

Введение

В .NET все объекты происходят от базового класса System.Object, который содержит метод ToString() для преобразования объекта в строку, но кроме этого метода, который не принимает никаких параметров, многие классы реализуют кроме еще несколько перегруженных методов ToString(), один из которых принимает строку форматирования. Об этом методе, а точнее о тех самых строках форматирования, которые надо им передавать мы и поговорим.

Форматирование целых и дробных чисел

Чтобы иметь возможность выбирать формат представления чисел, надо вызывать перегруженный метод ToString(), в который передается параметр типа System.String, которая и описывает форматирование. Эта строка должна содержать букву, которая описывает формат, и может содержать цифру, значение которой зависит от формата представления (т.е. от предшествующей буквы). Буквы, описывающие форматирования, могут быть следующие:

• "G" (или "g", так же этой строке равносильна пустая строка "" и null) в качестве основного формата;
• "E" (или "e") для экспоненциального вида;
• "F" (или "f") для представления чисел с фиксированной точкой;
• "N" (или "n") для числового представления с отделением тысяч, миллионов и т.д. пробелами;
• "R" (или "r") для такого строкового представления, что при использовании обратно метод Parse() получим то же самое число;
• "X" (или "x") для 16-ричного представления чисел;
• "P" (или "p") для процентного представления;
• "C" (или "c") для представления чисел в денежном формате.

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

Double:
1.2345678
5.6789e10
9.87654e-6

Int32:
123456789

Строка форматирования "G"

Начнем с самой простой строки форматирования. Она представляет собой основное (General) форматирование. Цифра после буквы обозначает сколько цифр будет выведено до символа экспоненты (если он понадобится). "g" и "G" отличаются тем, что в первом случае знак экспоненты будет обозначен маленькой буквой e, а во второй заглавной E. Если числа, написанные выше, преобразовывать в строку с использованием параметра "G", то они будут выведены так же, как и написаны выше. Но если их преобразовать строкой, например, "G3", то вот что получим:

Строка форматирования "E"

Эта строка форматирования используется, если нужно представить число в экспоненциальном виде. При этом число после буквы "E" (или "e") означает число чисел после запятой перед экспонентой. "e" и "E" отличаются тем, что в первом случае знак экспоненты будет обозначен маленькой буквой e, а во второй заглавной E. Вот как будут отформатированы те же числа с этой строкой форматирования:

Строка форматирования "F"

Эта строка форматирования нужна для представления чисел в формате с фиксированной точкой. Число после буквы "F" обозначает количество чисел после точки (по умолчанию два числа).

Обратите внимание на то, что осталось от маленького числа 9.87654e-6

Строка форматирования "N"

При использовании этой строки форматирования тысячи, миллионы и т.д. будут отделены пробелами. Число после буквы "N" обозначает количество цифр после точки

Строка форматирования "R"

Эта строка форматирования может использоваться в том случае, если позже полученная строка будет преобразовываться обратно в число и при этом гарантируется, что после такой обратной операции Вы получите исходное число. Эту строку форматирования можно использовать только для дробных чисел, при попытке использовать ее при типе Int32, бросается исключение FormatException. При использовании этой строки форматирования число после буквы "r" значения не имеет. Так же не имеет значения то, писать эту букву заглавной или прописной.

Строка форматирования "X"

Эта строка форматирования нужна для представления целых чисел в 16-ричной форме. При попытке ее использовать на дробных числах, бросается исключение FormatException. При использовании заглавной буквы "X" буквы A - F в 16-ричном представлении будут заглавными, а при использовании прописной "x" - прописные.

Форматирование с использованием метода String.Format

Метод String.Format удобно использовать, когда надо отформатировать сравнительно длинную строку с подстановками. Этот метод использует выражения, заключенные в фигурных скобках. Общий формат выражения выглядит как
{index[,alignment][:formatString]},
где index - номер переменной, который затем перечисляется в списке параметров, alignment - размер поля, которое отводится для этого числа, formatString - строка форматирования, аналогичная описанным выше (т.е. C, D, E, F, G, N или X). Таким образом могут быть записаны выражения вроде s = System.String ("Форматированное число: {0:G}", x), или s = System.String ("Форматированное число: {0:G3}", x), или s = System.String ("Форматированное число: {0,15:G3}", x). Примеры того как будет выглядеть результат показано в таблице:

Форматированное число: 1,2345678

Форматированное число: 1,23

Форматированное число:            1,23

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

Класс DateTime в своем методе ToString предлагает огромное число возможных строк форматирования. Все их подробно описывать нет смысла, поэтому вседем их в таблицу. Здесь тоже стоит обращать внимание на регистр букв, т.к. от него может отличаться та часть даты или времени, которая выводится. В качестве примера будем выводить дату "16 февраля (пятница) 2007 года 19 ч. 50 мин. 22 с."

Интересно, что мне по крайней мере не удалось найти как можно вывести только количество часов. До здравому смыслу должно быть что-то вроде "h" или "hh", но на эти строки форматирования метод ToString() бросает исключение FormatException. Также перечисленные выше символы форматирования можно использовать вместе в одной строке, при этому значение их может меняться. Например, строка "dd.M" выводит 16.2 (день.месяц), хотя отдельно M выводит число и месяц в полном формате.

Ну вот пожалуй и все. Надеюсь, что это кому-нибудь понадобится :)