Пользовательское форматирование столбцов временного диапазона
Если требуемый формат нельзя создать с данными параметрами, то собственные форматы можно создавать посредством пользовательских строк формата, написанных с использованием кода, примеры которого описаны в этом разделе. В формат TimeSpan входят пять разных значений даты: дни, часы, минуты, секунды и доли секунды.
Примеры.
Из этих значений можно составлять нужный формат с помощью строки формата, собранной из следующих специальных символов.
| Символ | Описание |
|---|---|
d |
Возвращает количество дней. |
h |
Возвращает количество часов, состоящее из одной или двух цифр в зависимости от значения. Это означает, что при применении этой строки формата шесть часов будет записано как «6» (а 11 часов будут записаны как «11»). |
hh |
Возвращает количество часов, состоящее из двух цифр. Это означает, что при применении этой строки формата шесть часов будет записано как «06». |
m |
Возвращает количество минут, состоящее из одной или двух цифр в зависимости от значения. Это означает, что при применении этой строки формата шесть минут будут записаны как «6» (а 11 минут будут записаны как «11»). |
mm |
Возвращает количество минут, состоящее из двух цифр. Это означает, что шесть минут будет записано как 06. |
s |
Возвращает количество секунд, состоящее из одной или двух цифр в зависимости от значения. Это означает, что при применении этой строки формата шесть секунд будут записаны как «6» (а 11 секунд будут записаны как «11»). |
ss |
Возвращает количество секунд, состоящее из двух цифр. Это означает, что шесть секунд будет записано как 06. |
f |
Возвращает доли секунды. При указании строк пользовательского формата можно, кроме того, добавить число от 1 до 3 после символа |
Между специальными символами необходимо указывать какой-либо разделитель. Это может быть пользовательское значение строки, однако, если какой-либо из указанных символов включен в строку, его необходимо экранировать с помощью обратной косой черты (\). Также можно включить начальную и конечную строку.
Во всех приведенных далее примерах используется следующее значение данных: -5 дней, 7 часов, 11 минут, 3,1234 секунды.
| Строка форматирования | Результат |
|---|---|
d.h:m:s.f |
-5.7:11:3.1 |
d.hh:mm:ss.f2 |
-5.07:11:03.12 |
Ti\me\span i\s d \day\s |
Timespan составляет -5 дней |
d \day\s h \hour\s m \minute\s s \secon\d\s
|
-5 дней, 7 часов, 11 минут 3 секунды. |
f s m h d |
123 3 11 7 -5 |