moduleceylon.time1.1.0
Source Code
ceylon.time
classPeriod
extends Basic
satisfies ReadablePeriod & ReadableTimePeriod & ReadableDatePeriod & PeriodBehavior<Period> & Comparable<Period> & Summable<Period> & Scalable<Integer,Period>
OverviewPackageAttributesInitializerMethods

An immutable period consisting of the ISO-8601 years, months, days, hours, minutes, seconds and milliseconds, such as '3 Months, 4 Days and 7 Hours'.

A period is a human-scale description of an amount of time.

no subtypes hierarchy

Initializer
Period(Integer years = 0, Integer months = 0, Integer days = 0, Integer hours = 0, Integer minutes = 0, Integer seconds = 0, Integer milliseconds = 0)
Parameters:
  • years = 0

    The number of years.

  • months = 0

    The number of months.

  • days = 0

    The number of days.

  • hours = 0

    The number of hours.

  • minutes = 0

    The number of minutes.

  • seconds = 0

    The number of seconds.

  • milliseconds = 0

    The number of milliseconds.

Attributes
dateOnlySource Codeshared actual ReadableDatePeriod dateOnly

Returns a date only view of this period.

Refines ReadablePeriod.dateOnly
daysSource Codeshared actual Integer days

The number of days.

Refines ReadableDatePeriod.days
hashSource Codeshared actual Integer hash

This implementation respect the constraint that if x==y then x.hash==y.hash.

Refines Identifiable.hash ultimately refines Object.hash
hoursSource Codeshared actual Integer hours

The number of hours.

Refines ReadableTimePeriod.hours
millisecondsSource Codeshared actual Integer milliseconds

The number of milliseconds.

Refines ReadableTimePeriod.milliseconds
minutesSource Codeshared actual Integer minutes

The number of minutes.

Refines ReadableTimePeriod.minutes
monthsSource Codeshared actual Integer months

The number of months.

Refines ReadableDatePeriod.months
secondsSource Codeshared actual Integer seconds

The number of seconds.

Refines ReadableTimePeriod.seconds
stringSource Codeshared actual String string

Returns the ISO-8601 formatted string for this period.

Refines Object.string
timeOnlySource Codeshared actual ReadableTimePeriod timeOnly

Returns a time only view of this period.

Refines ReadablePeriod.timeOnly
yearsSource Codeshared actual Integer years

The number of years.

Refines ReadableDatePeriod.years
Inherited Attributes
Attributes inherited from: ReadableDatePeriod
ReadableDatePeriod.days, ReadableDatePeriod.months, ReadableDatePeriod.years
Attributes inherited from: ReadablePeriod
ReadablePeriod.dateOnly, ReadablePeriod.timeOnly
Attributes inherited from: ReadableTimePeriod
ReadableTimePeriod.hours, ReadableTimePeriod.milliseconds, ReadableTimePeriod.minutes, ReadableTimePeriod.seconds
Methods
compareSource Codeshared actual Comparison compare(Period other)

Return the result of comparing this period to the other period.

Refines Comparable.compare
equalsSource Codeshared actual Boolean equals(Object that)

Checks if this period is equal to another period.

Refines Identifiable.equals ultimately refines Object.equals
isZeroSource Codeshared Boolean isZero()

Checks if this period is zero-length.

minusDaysSource Codeshared actual Period minusDays(Integer days)

Returns a copy of this period with the specified number of days subtracted.

Refines PeriodBehavior.minusDays
minusHoursSource Codeshared actual Period minusHours(Integer hours)

Returns a copy of this period with the specified number of hours subtracted.

Refines PeriodBehavior.minusHours
minusMillisecondsSource Codeshared actual Period minusMilliseconds(Integer milliseconds)

Returns a copy of this period with the specified number of milliseconds subtracted.

Refines PeriodBehavior.minusMilliseconds
minusMinutesSource Codeshared actual Period minusMinutes(Integer minutes)

Returns a copy of this period with the specified number of minutes subtracted.

Refines PeriodBehavior.minusMinutes
minusMonthsSource Codeshared actual Period minusMonths(Integer months)

Returns a copy of this period with the specified number of months subtracted.

Refines PeriodBehavior.minusMonths
minusSecondsSource Codeshared actual Period minusSeconds(Integer seconds)

Returns a copy of this period with the specified number of seconds subtracted.

Refines PeriodBehavior.minusSeconds
minusYearsSource Codeshared actual Period minusYears(Integer years)

Returns a copy of this period with the specified number of years subtracted.

Refines PeriodBehavior.minusYears
normalizedSource Codeshared actual Period normalized()

Returns a copy of this period with all amounts normalized to the standard ranges for date/time fields.

Two normalizations occur, one for years and months, and one for hours, minutes, seconds and milliseconds.

Days are not normalized, as a day may vary in length at daylight savings cutover. Neither is days normalized into months, as number of days per month varies from month to another and depending on the leap year.

Refines PeriodBehavior.normalized
plusSource Codeshared actual Period plus(Period other)

Returns a new period that is a sum of the two periods.

Refines Summable.plus
plusDaysSource Codeshared actual Period plusDays(Integer days)

Returns a copy of this period with the specified number of days added.

Refines PeriodBehavior.plusDays
plusHoursSource Codeshared actual Period plusHours(Integer hours)

Returns a copy of this period with the specified number of hours added.

Refines PeriodBehavior.plusHours
plusMillisecondsSource Codeshared actual Period plusMilliseconds(Integer milliseconds)

Returns a copy of this period with the specified number of milliseconds added.

Refines PeriodBehavior.plusMilliseconds
plusMinutesSource Codeshared actual Period plusMinutes(Integer minutes)

Returns a copy of this period with the specified number of minutes added.

Refines PeriodBehavior.plusMinutes
plusMonthsSource Codeshared actual Period plusMonths(Integer months)

Returns a copy of this period with the specified number of months added.

Refines PeriodBehavior.plusMonths
plusSecondsSource Codeshared actual Period plusSeconds(Integer seconds)

Returns a copy of this period with the specified number of seconds added.

Refines PeriodBehavior.plusSeconds
plusYearsSource Codeshared actual Period plusYears(Integer years)

Returns a copy of this period with the specified number of years added.

Refines PeriodBehavior.plusYears
scaleSource Codeshared actual Period scale(Integer scale)

Each field will be scalable independently, and the result will not be normalized

Refines Scalable.scale
withDaysSource Codeshared actual Period withDays(Integer days)

Returns a copy of this period with the specified amount of days.

Refines PeriodBehavior.withDays
withHoursSource Codeshared actual Period withHours(Integer hours)

Returns a copy of this period with the specified amount of hours.

Refines PeriodBehavior.withHours
withMillisecondsSource Codeshared actual Period withMilliseconds(Integer milliseconds)

Returns a copy of this period with the specified amount of milliseconds.

Refines PeriodBehavior.withMilliseconds
withMinutesSource Codeshared actual Period withMinutes(Integer minutes)

Returns a copy of this period with the specified amount of minutes.

Refines PeriodBehavior.withMinutes
withMonthsSource Codeshared actual Period withMonths(Integer months)

Returns a copy of this period with the specified amount of months.

Refines PeriodBehavior.withMonths
withSecondsSource Codeshared actual Period withSeconds(Integer seconds)

Returns a copy of this period with the specified amount of seconds.

Refines PeriodBehavior.withSeconds
withYearsSource Codeshared actual Period withYears(Integer years)

Returns a copy of this period with the specified amount of years.

Refines PeriodBehavior.withYears
Inherited Methods
Methods inherited from: Comparable<Other>
Comparable.compare(), Comparable.largerThan(), Comparable.notLargerThan(), Comparable.notSmallerThan(), Comparable.smallerThan()
Methods inherited from: PeriodBehavior<Self>
PeriodBehavior.minusDays(), PeriodBehavior.minusHours(), PeriodBehavior.minusMilliseconds(), PeriodBehavior.minusMinutes(), PeriodBehavior.minusMonths(), PeriodBehavior.minusSeconds(), PeriodBehavior.minusYears(), PeriodBehavior.normalized(), PeriodBehavior.plusDays(), PeriodBehavior.plusHours(), PeriodBehavior.plusMilliseconds(), PeriodBehavior.plusMinutes(), PeriodBehavior.plusMonths(), PeriodBehavior.plusSeconds(), PeriodBehavior.plusYears(), PeriodBehavior.withDays(), PeriodBehavior.withHours(), PeriodBehavior.withMilliseconds(), PeriodBehavior.withMinutes(), PeriodBehavior.withMonths(), PeriodBehavior.withSeconds(), PeriodBehavior.withYears()
Methods inherited from: Scalable<Scale,Value>
Scalable.scale()
Methods inherited from: Summable<Other>
Summable.plus()