Преобразует объект в строковое представление
Типы часто переопределяют, чтобы предоставить более подходящее строковое представление определенного типа. Типы также часто перегружают , чтобы обеспечить поддержку для строк формата или форматирования с учетом языка и региональных параметров.
Синтаксис:
object.ToString(format)
где:
object - объект преобразования в строку ( может быть типа: дата, число и т.д.)
format - формат преобразования, для разлиных типов:
Возвращаемый тип данных:
строка
Форматы преобразования:
Для форматирования вывода дат и времени применяется ряд строковых форматов:
| Описатель | Описание |
|---|---|
| D | Поный формат даты. Например, 17 июля 2015 г. |
| d | Краткий формат даты. Например, 17.07.2015 |
| F | Полный формат даты и времени. Например, 17 июля 2015 г. 17:04:43 |
| f | Полный формат даты и краткий формат времени. Например, 17 июля 2015 г. 17:04 |
| G | Краткий формат даты и полный формат времени. Например, 17.07.2015 17:04:43 |
| g | Краткий формат даты и времени. Например, 17.07.2015 17:04 |
| M, m | Формат дней месяца. Например, 17 июля |
| O, o | Формат обратного преобразования даты и времени. Вывод даты и времени в соответствии со стандартом ISO 8601 в формате «yyyy’-‘MM’-‘dd’T’HH’:’mm’:’ss’.’fffffffzzz». Например, 2015-07-17T17:04:43.4092892+03:00 |
| R, r | Время по Гринвичу. Например, Fri, 17 Jul 2015 17:04:43 GMT |
| s | Сортируемый формат даты и времени. Например, 2015-07-17T17:04:43 |
| T | Полный формат времени. Например, 17:04:43 |
| t | Краткий формат времени. Например, 17:04 |
| U | Полный универсальный полный формат даты и времени. Например, 17 июля 2015 г. 17:04:43 |
| u | Краткий универсальный полный формат даты и времени. Например, 2015-07-17 17:04:43Z |
| Y, y | Формат года. Например, Июль 2015 |
Для форматирования чисел применяется ряд строковых форматов:
| Описатель | Описание | Пример |
|---|---|---|
| "0" | Заменяет ноль соответствующей цифрой, если она присутствует; в противном случае в строке результата появляется ноль. | 1234.5678 ("00000") -> 01235 0.45678 ("0.00", en-US) -> 0.46 0.45678 ("0.00", fr-FR) -> 0,46 |
| "#" | Заменяет символ "#" соответствующей цифрой, если она присутствует; в противном случае в строке результата не появляется цифра. Обратите внимание, что в результирующей строке не появляется цифра, если соответствующая цифра во входной строке является незначащим 0. Например, 0003 ("####") -> 3. | 1234.5678 ("#####") -> 1235 0.45678 ("#.##", en-US) -> .46 0.45678 ("#.##", fr-FR) -> ,46 |
| "." | Определяет расположение десятичного разделителя в строке результата. | 0.45678 ("0.00", en-US) -> 0.46 0.45678 ("0.00", fr-FR) -> 0,46 |
| "," | Служит как разделителем групп, так и спецификатором масштабирования чисел. В качестве разделителя групп он вставляет локализованный символ разделителя групп между каждой группой. Как спецификатор масштабирования числа, он делит число на 1000 для каждой указанной запятой. | Group separator specifier: 2147483647 ("##,#", en-US) -> 2,147,483,647 2147483647 ("##,#", es-ES) -> 2.147.483.647 Scaling specifier: 2147483647 ("#,#,,", en-US) -> 2,147 2147483647 ("#,#,,", es-ES) -> 2.147 |
| "%" | Умножает число на 100 и вставляет локализованный символ процента в результирующую строку. | 0.3697 ("%#0.00", en-US) -> %36.97 0.3697 ("%#0.00", el-GR) -> %36,97 0.3697 ("##.0 %", en-US) -> 37.0 % 0.3697 ("##.0 %", el-GR) -> 37,0 % |
| "‰" | Умножает число на 1000 и вставляет в результирующую строку локализованный символ промилле. | 0.03697 ("#0.00‰", en-US) -> 36.97‰ 0.03697 ("#0.00‰", ru-RU) -> 36,97‰ |
| "E0" "E+0" "E-0" "e0" "e+0" "e-0" | Если за ним следует хотя бы один 0 (ноль), результат форматируется с использованием экспоненциальной записи. Регистр «E» или «e» указывает регистр символа экспоненты в строке результата. Количество нулей, следующих за символом «Е» или «е», определяет минимальное количество цифр в показателе степени. Знак плюс (+) указывает, что символ знака всегда предшествует показателю степени. Знак минус (-) указывает, что знак знака предшествует только отрицательным показателям степени. | 987654 ("#0.0e0") -> 98.8e4 1503.92311 ("0.0##e+00") -> 1.504e+03 1.8901385E-16 ("0.0e+00") -> 1.9e-16 |
| "\" | Заставляет следующий символ интерпретироваться как литерал, а не как спецификатор пользовательского формата. | 987654 ("\###00\#") -> #987654# |
| 'string' "string" | Указывает, что заключенные в них символы должны быть скопированы в результирующую строку без изменений. | 68 ("# 'degrees'") -> 68 degrees 68 ("#' degrees'") -> 68 degrees |
| ; | Определяет разделы с отдельными строками формата для положительных, отрицательных и нулевых чисел. | 12.345 ("#0.0#;(#0.0#);-\0-") -> 12.35 0 ("#0.0#;(#0.0#);-\0-") -> -0- |
Примеры: