FormatTimeSpan

Определение

Пространство имён

Resto.Front.PrintTemplates.Cheques.Razor

Форматирует длительность как общее количество часов и минуты, при необходимости с секундами.

string TemplateBase<T>.FormatTimeSpan(TimeSpan timeSpan, bool displaySeconds)

Возвращает

string

Допустимость null

Не указана

Объявлено в

Resto.Front.PrintTemplates.Cheques.Razor.TemplateBase<T>

Назначение модели

Базовый класс шаблонов печати Legacy Razor. Model содержит данные документа типа T. Предоставляет методы форматирования и вывода разметки.

Параметры

TimeSpan timeSpan

Длительность для вывода; обычно неотрицательная.

bool displaySeconds

True — часы:минуты:секунды; false — часы:минуты с округлением по компоненту секунд.

Возвращаемое значение

Компоненты через двоеточие, каждый минимум из двух цифр; часы могут превышать 23.

Особенности поведения

При выводе секунд доли секунды отбрасываются. Без секунд одна минута добавляется только при TimeSpan.Seconds >= 30. TotalHours приводится к Int32; значения за его пределами надёжно не поддерживаются. Отрицательная длительность не нормализуется к одному знаку минус: компоненты сохраняют собственные знаки, отрицательные секунды не вызывают округление.

Исключения

System.OverflowException

Добавление минуты при округлении превышает TimeSpan.MaxValue.

Пример

FormatTimeSpan(new TimeSpan(1, 2, 3, 30), true); // "26:03:30"
FormatTimeSpan(new TimeSpan(1, 2, 3, 30), false); // "26:04"