TimeFormat class
Allows a Time to be formatted.
See UnitOfMeasurementFormat for general notes on the pattern syntax, which you can combine with the TimeUnit pattern specifiers as required:
Unit | Specifier |
---|---|
nanosecond | ns |
microsecond | μs |
millisecond | ms |
centisecond | cs |
decisecond | ds |
second | s |
decasecond | das |
minute | min |
hour | hr |
day | d |
week | wk |
fortnight | fn |
month | mo |
quarter | qr |
year | yr |
decade | dec |
century | c |
final time = 42.minutes();
// '42min'
final result1 = TimeFormat().format(time);
// '42 minutes'
final result2 = TimeFormat(pattern: '0.## U').format(time);
// '2,520,000 ms'
final result3 = TimeFormat(pattern: '###,##0.## u:ms').format(time);
See also:
- Inheritance
-
- Object
- UnitOfMeasurementFormat<
Time, TimeUnit> - TimeFormat
Constructors
-
TimeFormat({String pattern = '0.##${UnitOfMeasurementFormat.valueUnitSymbolFormatSpecifier}', Set<
TimeUnit> permissibleValueUnits = TimeUnits.common, String? locale})
Properties
- hashCode → int
-
The hash code for this object.
no setterinherited
- locale → String?
-
The locale to use when formatting values.
finalinherited
- pattern → String
-
The pattern that indicates the desired output when formatting input values.
finalinherited
-
permissibleRateUnits
→ Set<
RateUnit> -
finalinherited
-
permissibleValueUnits
→ Set<
TimeUnit> -
finalinherited
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
Methods
-
format(
Time input) → String -
Formats
input
according to the pattern and locale of this format.inherited -
getLargestUnit(
Time input) → TimeUnit -
Determines the largest denomination of unit in
input
that has a value of at least1
.override -
getPatternSpecifierFor(
TimeUnit valueUnit) → String -
Gets the pattern specifier for the given value unit.
inherited
-
getPermissibleRateUnits(
) → Set< RateUnit> -
Gets a set of permissible
RateUnit
values.inherited -
getPermissibleValueUnits(
) → Set< TimeUnit> -
Gets a set of permissible
TUnit
values.inherited -
getUnitName(
TimeUnit unit, String locale) → String -
Gets the a
unit
name in the givenlocale
.inherited -
getUnitQuantity(
Time input, TimeUnit unit) → Rational -
Determines how many units of
unit
theinput
contains, including any fractional portion.override -
getUnitSymbol(
TimeUnit unit, String locale) → String -
Gets the a
unit
symbol in the givenlocale
.inherited -
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
pluralizeValueUnits(
String locale) → bool -
Determines whether value units should be pluralized. Defaults to
true
.inherited -
scaleToRateUnit(
Time input, RateUnit rateUnit) → Time -
Scales
input
, which is assumed to be a rated unit of measurement, so that its rate israteUnit
.override -
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited