Package net.time4j.range

Class Weeks

java.lang.Object

net.time4j.range.SingleUnitTimeSpan<CalendarUnit,Weeks>

net.time4j.range.Weeks

All Implemented Interfaces:

Serializable, Comparable<Weeks>, TimeSpan<CalendarUnit>

public final class Weeks
extends SingleUnitTimeSpan<CalendarUnit,Weeks>

Represents a time span in 7-day weeks.

Since:

3.21/4.17

Author:

Meno Hochschild

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface net.time4j.engine.TimeSpan

TimeSpan.Item<U>

Field Summary

Fields

Modifier and Type	Field	Description
static Weeks	ONE	Constant for exactly one week.
static Weeks	ZERO	Constant for zero weeks.

Method Summary

Modifier and Type	Method	Description
static Weeks	between(CalendarWeek w1, CalendarWeek w2)	Determines the difference in weeks between given quarter years.
static <T extends TimePoint<? super CalendarUnit, T>> Weeks	between(T t1, T t2)	Determines the temporal distance between given dates/time-points in weeks.
static Weeks	of(int weeks)	Obtains a time span in given weeks.
static Weeks	parsePeriod(String period)	Parses the canonical ISO-8601-format "PnW" with possible preceding minus-char.

Methods inherited from class net.time4j.range.SingleUnitTimeSpan

abs, addTo, compareTo, contains, equals, getAmount, getPartialAmount, getTotalLength, getUnit, hashCode, inverse, isEmpty, isNegative, isPositive, minus, minus, multipliedBy, plus, plus, subtractFrom, toStdDuration, toString, toString

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Field Details

ZERO

public static final Weeks ZERO

Constant for zero weeks.

ONE

public static final Weeks ONE

Constant for exactly one week.

Method Details

of

public static Weeks of(int weeks)

Obtains a time span in given weeks.

Parameters:

weeks - count of weeks, maybe negative

Returns:

time span in weeks

See Also:

CalendarUnit.WEEKS

between

public static <T extends TimePoint<? super CalendarUnit,
T>>
Weeks between(T t1,
 T t2)

Determines the temporal distance between given dates/time-points in weeks.

Type Parameters:

T - generic type of time-points

Parameters:

t1 - first time-point

t2 - second time-point

Returns:

result of week difference

See Also:

PlainDate, PlainTimestamp

between

public static Weeks between(CalendarWeek w1,
 CalendarWeek w2)

Determines the difference in weeks between given quarter years.

Parameters:

w1 - first calendar week

w2 - second calendar week

Returns:

difference in weeks

parsePeriod

public static Weeks parsePeriod(String period)
                         throws ParseException

Parses the canonical ISO-8601-format "PnW" with possible preceding minus-char.

Parameters:

period - the formatted string to be parsed

Returns:

parsed instance

Throws:

ParseException - if given argument cannot be parsed