Fuzion Logo
fuzion-lang.dev — The Fuzion Language Portal
JavaScript seems to be disabled. Functionality is limited.

duration

time.duration

:
Period,orderable,hashable
 is
[Private constructor]
time.duration -- value representing a duration, i.e., a time span

This is intended for high precision time specification and measurement, it
uses a time resolution of 1ns.

The maximum value is about 580 years, so this is not intended for use in
calendars that may require time spans exceeding several centuries or millennia,
nor astrological time spans.

Fields

nanos
 u64
the duration in nano seconds

Functions

For `duration`, this feature redefined from `Period` will just return an equal `duration`
like `duration.this`.
 => 
String
[Redefinition of  Any.as_string]
create a string representation of this duration. The string
representation is not accurate, it consists of at least two
and at most 4 decimal digits followed by a time unit string.

redefines:

create a string representation of this duration using the given unit.
this duration in whole days, omitting fractional part
(R 
type
, F 
type
: Typed_Function R, f F)
 => 
R
[Inherited from  Any]
dynamic_apply -- apply `f.call` to `Any.this`'s dynamic type and value

This can be used to perform operation on values depending on their dynamic
type.

Here is an example that takes a `Sequence Any` that may contain boxed values
of types `i32` and `f64`. We can now write a feature `get_f64` that extracts
these values converted to `f64` and build a function `sum` that sums them up
as follows:


NYI: IMPROVEMENT: #5892: If this is fixed, we could write

 => 
Type
[Inherited from  Any]
Get the dynamic type of this instance. For value instances `x`, this is
equal to `type_of x`, but for `x` with a `ref` type `x.dynamic_type` gives
the actual runtime type, while `type_of x` results in the static
compile-time type.

There is no dynamic type of a type instance since this would result in an
endless hierarchy of types. So for Type values, dynamic_type is redefined
to just return Type.type.
this duration in whole hours, omitting fractional part
this duration multiplied by factor n
this duration and another one combined
this duration minus another duration
this duration divided by duration other, rounding down
is this period infinite, i.e., it never ends?
this duration in micro seconds, omitting fractional part
this duration in milli seconds, omitting fractional part
this duration in whole minutes, omitting fractional part
 => 
String
[Inherited from  Any]
convenience prefix operator to create a string from a value.

This permits usage of `$` as a prefix operator in a similar way both
inside and outside of constant strings: $x and "$x" will produce the
same string.
this duration in whole seconds, omitting fractional part
this duration multiplied by factor f
create a string representation of this duration. The string
representation is not accurate, it consists of at least two
and at most 4 decimal digits followed by a time unit string.
this duration in whole weeks, omitting fractional part
this duration in whole Julian years, omitting fractional part

Type Functions

create duration of n years

NYI: Turn this into a 'postfix' call, see https://fuzion-lang.dev/design/postfix_calls
 => 
String
[Inherited from  Type]
string representation of this type to be used for debugging.

result has the form "Type of '<name>'", but this might change in the future

redefines:

create duration of n days

NYI: Turn this into a 'postfix' call, see https://fuzion-lang.dev/design/postfix_calls
 => 
Type
[Inherited from  Type]
There is no dynamic type of a type instance since this would result in an
endless hierarchy of types, so dynamic_type is redefined to just return
Type.type here.

redefines:

(a property.orderable.this.type, b property.orderable.this.type)
 => 
bool
[Inherited from  orderable]
equality implements the default equality relation for values of this type.

This relation must be

- reflexive (equality a a),
- symmetric (equality a b = equality b a), and
- transitive ((equality a b && equality b c) : equality a c).

result is true iff 'a' is considered to represent the same abstract value
as 'b'.
create duration of n hours

NYI: Turn this into a 'postfix' call, see https://fuzion-lang.dev/design/postfix_calls
(d time.duration.this.type)
 => 
u64
create hash code from a duration
create duration of n hours

NYI: Turn this into a 'postfix' call, see https://fuzion-lang.dev/design/postfix_calls
(T 
type
)
 => 
bool
[Inherited from  Type]
Is this type assignable to a type parameter with constraint `T`?

The result of this is a compile-time constant that can be used to specialize
code for a particular type.


it is most useful in conjunction with preconditions or `if` statements as in


or

total order
the maximum duration
max value for a duration given in days
max value for a duration given in hours
max value for a duration given in micros
max value for a duration given in millis
max value for a duration given in minutes
max value for a duration given in nanos
max value for a duration given in seconds
max value for a duration given in weeks
max value for a duration given in years
create duration of n min

NYI: Turn this into a 'postfix' call, see https://fuzion-lang.dev/design/postfix_calls
create duration of n min

NYI: Turn this into a 'postfix' call, see https://fuzion-lang.dev/design/postfix_calls
create duration of n ms

NYI: Turn this into a 'postfix' call, see https://fuzion-lang.dev/design/postfix_calls
 => 
String
[Inherited from  Type]
name of this type, including type parameters, e.g. 'option (list i32)'.
create duration of n ns

NYI: Turn this into a 'postfix' call, see https://fuzion-lang.dev/design/postfix_calls
 => 
String
[Inherited from  Type]
convenience prefix operator to create a string from a value.

This permits usage of `$` as a prefix operator in a similar way both
inside and outside of constant strings: $x and "$x" will produce the
same string.

NYI: Redefinition allows the type feature to be distinguished from its normal counterpart, see #3913

redefines:

create duration of n seconds

NYI: Turn this into a 'postfix' call, see https://fuzion-lang.dev/design/postfix_calls
create duration of n seconds

NYI: Turn this into a 'postfix' call, see https://fuzion-lang.dev/design/postfix_calls
 => 
Type
[Inherited from  Any]
Get a type as a value.

This is a feature with the effect equivalent to Fuzion's `expr.type` call tail.
It is recommended to use `expr.type` and not `expr.type_value`.

`type_value` is here to show how this can be implemented and to illustrate the
difference to `dynamic_type`.
create duration of n weeks

NYI: Turn this into a 'postfix' call, see https://fuzion-lang.dev/design/postfix_calls
create duration of n years

NYI: Turn this into a 'postfix' call, see https://fuzion-lang.dev/design/postfix_calls
the zero duration, representing a time span of zero
create duration of n µs

NYI: Turn this into a 'postfix' call, see https://fuzion-lang.dev/design/postfix_calls

Applicable universe features

These are features in universe, that have an argument with a type constraint that matches this features type and can therefore be used with it.
(T 
type
:
property.equatable, a T, b T)
 => 
bool
equals -- feature that compares two values using the equality relation
defined in their type
(T 
type
:
property.hashable, a T)
 => 
u64
hash of a value
(T 
type
:
property.equatable, a T, b T)
 => 
bool
infix = -- infix operation as short-hand for 'equals'
(T 
type
:
property.orderable, a T, b T)
 => 
bool
does this come strictly before other?
infix <= -- infix operation as short-hand for 'lteq'
(T 
type
:
property.orderable, a T, b T)
 => 
order
three-way comparison between this and other.

result is < 0 if this < other
result is > 0 if this > other
result is = 0 if this = other
(T 
type
:
property.equatable, a T, b T)
 => 
bool
infix = -- infix operation as short-hand for 'equals'
(T 
type
:
property.orderable, a T, b T)
 => 
bool
does this come strictly after other?
(T 
type
:
property.orderable, a T, b T)
 => 
bool
does this come after other?
is `a` contained in `Set` `s`?

This should usually be called using type inference as in

is `a` not contained in `Set` `s`?

This should usually be called using type inference as in

(T 
type
:
property.equatable, a T, b T)
 => 
bool
infix ≟ -- infix operation as short-hand for 'equals'
infix ≤ -- infix operation as short-hand for 'lteq'
(T 
type
:
property.orderable, a T, b T)
 => 
bool
does this come after other?
(T 
type
:
property.orderable, a T, b T)
 => 
order
three-way comparison between this and other.

result is < 0 if this < other
result is > 0 if this > other
result is = 0 if this = other
(T 
type
:
property.orderable, a T, b T)
 => 
bool
does this come strictly before other?
(T 
type
:
property.orderable, a T, b T)
 => 
bool
does this come strictly after other?
(T 
type
:
property.partially_orderable, a T, b T)
 => 
bool
lteq -- feature that compares two values using the lteq relation
defined in their type
(T 
type
:
property.orderable, a T, b T)
 => 
T
maximum of two values
memoize `f`.
wraps f so that f will only be called once for every unique input.

The term "memoization" was coined by Donald Michie in 1968 and
is derived from the Latin word "memorandum" ("to be remembered"),
usually truncated as "memo" in American English, and thus carries
the meaning of "turning a function into something to be remembered".
https://en.wikipedia.org/wiki/Memoization

example:

(T 
type
:
property.orderable, a T, b T)
 => 
T
minimum of two values
0.095dev (2025-09-09 14:29:31 GIT hash 98644f8f651c2101a0730cfe31c5807993b7603b built by fridi@fzen)