edu.stanford.nlp.time
Class SUTime

java.lang.Object
  edu.stanford.nlp.time.SUTime

public class SUTime
extends java.lang.Object

SUTime is a collection of data structures to represent various temporal concepts and operations between them. Different types of time expressions

• Time - A time point on a time scale In most cases, we only know partial information (with a certain granularity) about a point in time (8:00pm)
• Duration - A length of time (3 days)
• Interval - A range of time with start and end points
• Set - A set of time: Can be periodic (Friday every week) or union (Thursday or Friday)

Use TimeAnnotator to annotate.

Author:

Angel Chang

Nested Class Summary

static class	SUTime.CompositePartialTime
static class	SUTime.Duration A Duration represents a period of time (without endpoints) We have 3 types of durations: DurationWithFields - corresponds to JodaTime Period, where we have fields like hours, weeks, etc DurationWithMillis - corresponds to JodaTime Duration, where the duration is specified in millis this gets rid of certain ambiguities such as a month with can be 28, 30, or 31 days InexactDuration - duration that is under determined (like a few days)
static class	SUTime.DurationRange A range of durations.
static class	SUTime.DurationWithFields Duration that is specified using fields such as milliseconds, days, etc.
static class	SUTime.DurationWithMillis Duration specified in terms of milliseconds
static class	SUTime.ExplicitTemporalSet Explicit set of times: like tomorrow and next week, not really used
static class	SUTime.GroundedTime
static class	SUTime.InexactDuration Duration that is inexact.
static class	SUTime.InexactTime Inexact time, not sure when this is, but have some quesses
static class	SUTime.IsoDate
protected static class	SUTime.IsoDateTime
protected static class	SUTime.IsoTime
static class	SUTime.OrdinalTime
static class	SUTime.PartialTime
static class	SUTime.PeriodicTemporalSet PeriodicTemporalSet represent a set of times that occurs with some frequency.
static class	SUTime.Range A time interval
static class	SUTime.RefTime
static class	SUTime.RelativeTime
static class	SUTime.SimpleTime Simple time (vague time that we don't really know what to do with)
static class	SUTime.StandardTemporalType
static class	SUTime.Temporal Basic temporal object
static class	SUTime.TemporalOp
static class	SUTime.TemporalSet Exciting set of times
static class	SUTime.Time Time represents a time point on some time scale.
static class	SUTime.TimeIndex
static class	SUTime.TimeUnit
static class	SUTime.TimeWithRange
static class	SUTime.TimexAttr
static class	SUTime.TimexDocFunc
static class	SUTime.TimexMod
static class	SUTime.TimexType

Field Summary

static SUTime.Time	AFTERNOON
static SUTime.Time	APRIL
static SUTime.Time	AUGUST
static SUTime.Duration	CENTURY
static SUTime.PeriodicTemporalSet	DAILY
static SUTime.Time	DAWN
static SUTime.Duration	DAY
static SUTime.Time	DAYTIME
static SUTime.Duration	DECADE
static SUTime.Time	DECEMBER
static SUTime.Time	DINNERTIME
static int	DUR_RESOLVE_FROM_AS_REF
static int	DUR_RESOLVE_TO_AS_REF
static SUTime.Duration	DURATION_NONE
static SUTime.Duration	DURATION_UNKNOWN
static SUTime.Time	DUSK
static int	ERA_AD
static int	ERA_BC
static int	ERA_UNKNOWN
static SUTime.Time	EVENING
static SUTime.Time	EVENING_TWILIGHT
static SUTime.Time	FALL
static SUTime.Time	FALL_EQUINOX
static SUTime.Time	FEBRUARY
static int	FORMAT_FULL
static int	FORMAT_ISO
static int	FORMAT_PAD_UNKNOWN
static int	FORMAT_TIMEX3_VALUE
static SUTime.Duration	FORTNIGHT
static SUTime.Time	FRIDAY
static int	HALFDAY_AM
static int	HALFDAY_PM
static int	HALFDAY_UNKNOWN
static SUTime.Duration	HALFHOUR
static SUTime.Duration	HOUR
static SUTime.PeriodicTemporalSet	HOURLY
static SUTime.Time	JANUARY
static SUTime.Time	JULY
static SUTime.Time	JUNE
static SUTime.Time	LUNCHTIME
static SUTime.Time	MARCH
static SUTime.Time	MAY
static SUTime.PartialTime	MIDNIGHT
static SUTime.Duration	MILLENNIUM
static SUTime.Duration	MILLIS
static SUTime.Duration	MINUTE
static SUTime.Time	MONDAY
static SUTime.Duration	MONTH
static SUTime.PeriodicTemporalSet	MONTHLY
static SUTime.Time	MORNING
static SUTime.Time	MORNING_TWILIGHT
static SUTime.Time	NIGHT
static SUTime.PeriodicTemporalSet	NIGHTLY
static SUTime.PartialTime	NOON
static SUTime.Time	NOVEMBER
static SUTime.Time	OCTOBER
static java.lang.String	PAD_FIELD_UNKNOWN
static java.lang.String	PAD_FIELD_UNKNOWN2
static java.lang.String	PAD_FIELD_UNKNOWN4
static SUTime.Duration	QUARTER
static SUTime.Duration	QUARTERHOUR
static SUTime.PeriodicTemporalSet	QUARTERLY
static int	RANGE_EXPAND_FIX_BEGIN
static int	RANGE_EXPAND_FIX_END
static int	RANGE_FLAGS_PAD_AUTO
static int	RANGE_FLAGS_PAD_FINEST
static int	RANGE_FLAGS_PAD_MASK
static int	RANGE_FLAGS_PAD_NONE
static int	RANGE_FLAGS_PAD_SPECIFIED
static int	RANGE_OFFSET_BEGIN
static int	RANGE_OFFSET_END
static int	RANGE_RESOLVE_TIME_REF
static int	RESOLVE_NOW
static int	RESOLVE_TO_CLOSEST
static int	RESOLVE_TO_FUTURE
static int	RESOLVE_TO_PAST
static int	RESOLVE_TO_THIS
static SUTime.Time	SATURDAY
static SUTime.Duration	SECOND
static SUTime.Time	SEPTEMBER
static SUTime.Time	SPRING
static SUTime.Time	SPRING_EQUINOX
static SUTime.Time	SUMMER
static SUTime.Time	SUMMER_SOLSTICE
static SUTime.Time	SUNDAY
static SUTime.Time	SUNRISE
static SUTime.Time	SUNSET
static SUTime.Time	TEATIME
static SUTime.Time	THURSDAY
static SUTime.Time	TIME_FUTURE
static SUTime.Time	TIME_NONE
static SUTime.Time	TIME_NONE_OK
static SUTime.Time	TIME_NOW
static SUTime.Time	TIME_PAST
static SUTime.Time	TIME_PRESENT
static SUTime.Time	TIME_REF
static SUTime.Time	TIME_REF_UNKNOWN
static SUTime.Time	TIME_UNKNOWN
protected static int	timexVersion
static SUTime.RelativeTime	TODAY
static SUTime.RelativeTime	TOMORROW
static SUTime.RelativeTime	TONIGHT
static SUTime.Time	TUESDAY
static SUTime.TemporalSet	TWILIGHT
static SUTime.Time	WEDNESDAY
static SUTime.Duration	WEEK
static SUTime.Time	WEEKDAY
static SUTime.Time	WEEKEND
static SUTime.PeriodicTemporalSet	WEEKLY
static SUTime.Time	WINTER
static SUTime.Time	WINTER_SOLSTICE
static SUTime.Duration	YEAR
static SUTime.PeriodicTemporalSet	YEARLY
static SUTime.RelativeTime	YESTERDAY

Method Summary

static <T extends SUTime.Temporal> T	createTemporal(SUTime.StandardTemporalType timeType, java.lang.String label, java.lang.String mod, T temporal)
static <T extends SUTime.Temporal> T	createTemporal(SUTime.StandardTemporalType timeType, java.lang.String label, T temporal)
static <T extends SUTime.Temporal> T	createTemporal(SUTime.StandardTemporalType timeType, T temporal)
static SUTime.Time	parseDateTime(java.lang.String dateStr) Converts a string that represents some kind of date into ISO 8601 format and returns it as a SUTime.Time YYYYMMDDThhmmss

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

PAD_FIELD_UNKNOWN

public static final java.lang.String PAD_FIELD_UNKNOWN

See Also:

Constant Field Values

PAD_FIELD_UNKNOWN2

public static final java.lang.String PAD_FIELD_UNKNOWN2

See Also:

Constant Field Values

PAD_FIELD_UNKNOWN4

public static final java.lang.String PAD_FIELD_UNKNOWN4

See Also:

Constant Field Values

RESOLVE_NOW

public static final int RESOLVE_NOW

See Also:

Constant Field Values

RESOLVE_TO_THIS

public static final int RESOLVE_TO_THIS

See Also:

Constant Field Values

RESOLVE_TO_PAST

public static final int RESOLVE_TO_PAST

See Also:

Constant Field Values

RESOLVE_TO_FUTURE

public static final int RESOLVE_TO_FUTURE

See Also:

Constant Field Values

RESOLVE_TO_CLOSEST

public static final int RESOLVE_TO_CLOSEST

See Also:

Constant Field Values

DUR_RESOLVE_TO_AS_REF

public static final int DUR_RESOLVE_TO_AS_REF

See Also:

Constant Field Values

DUR_RESOLVE_FROM_AS_REF

public static final int DUR_RESOLVE_FROM_AS_REF

See Also:

Constant Field Values

RANGE_RESOLVE_TIME_REF

public static final int RANGE_RESOLVE_TIME_REF

See Also:

Constant Field Values

RANGE_OFFSET_BEGIN

public static final int RANGE_OFFSET_BEGIN

See Also:

Constant Field Values

RANGE_OFFSET_END

public static final int RANGE_OFFSET_END

See Also:

Constant Field Values

RANGE_EXPAND_FIX_BEGIN

public static final int RANGE_EXPAND_FIX_BEGIN

See Also:

Constant Field Values

RANGE_EXPAND_FIX_END

public static final int RANGE_EXPAND_FIX_END

See Also:

Constant Field Values

RANGE_FLAGS_PAD_MASK

public static final int RANGE_FLAGS_PAD_MASK

See Also:

Constant Field Values

RANGE_FLAGS_PAD_NONE

public static final int RANGE_FLAGS_PAD_NONE

See Also:

Constant Field Values

RANGE_FLAGS_PAD_AUTO

public static final int RANGE_FLAGS_PAD_AUTO

See Also:

Constant Field Values

RANGE_FLAGS_PAD_FINEST

public static final int RANGE_FLAGS_PAD_FINEST

See Also:

Constant Field Values

RANGE_FLAGS_PAD_SPECIFIED

public static final int RANGE_FLAGS_PAD_SPECIFIED

See Also:

Constant Field Values

FORMAT_ISO

public static final int FORMAT_ISO

See Also:

Constant Field Values

FORMAT_TIMEX3_VALUE

public static final int FORMAT_TIMEX3_VALUE

See Also:

Constant Field Values

FORMAT_FULL

public static final int FORMAT_FULL

See Also:

Constant Field Values

FORMAT_PAD_UNKNOWN

public static final int FORMAT_PAD_UNKNOWN

See Also:

Constant Field Values

timexVersion

protected static final int timexVersion

See Also:

Constant Field Values

YEAR

public static final SUTime.Duration YEAR

DAY

public static final SUTime.Duration DAY

WEEK

public static final SUTime.Duration WEEK

FORTNIGHT

public static final SUTime.Duration FORTNIGHT

MONTH

public static final SUTime.Duration MONTH

QUARTER

public static final SUTime.Duration QUARTER

MILLIS

public static final SUTime.Duration MILLIS

SECOND

public static final SUTime.Duration SECOND

MINUTE

public static final SUTime.Duration MINUTE

HOUR

public static final SUTime.Duration HOUR

HALFHOUR

public static final SUTime.Duration HALFHOUR

QUARTERHOUR

public static final SUTime.Duration QUARTERHOUR

DECADE

public static final SUTime.Duration DECADE

CENTURY

public static final SUTime.Duration CENTURY

MILLENNIUM

public static final SUTime.Duration MILLENNIUM

TIME_REF

public static final SUTime.Time TIME_REF

TIME_REF_UNKNOWN

public static final SUTime.Time TIME_REF_UNKNOWN

TIME_UNKNOWN

public static final SUTime.Time TIME_UNKNOWN

TIME_NONE

public static final SUTime.Time TIME_NONE

TIME_NONE_OK

public static final SUTime.Time TIME_NONE_OK

TIME_NOW

public static final SUTime.Time TIME_NOW

TIME_PRESENT

public static final SUTime.Time TIME_PRESENT

TIME_PAST

public static final SUTime.Time TIME_PAST

TIME_FUTURE

public static final SUTime.Time TIME_FUTURE

DURATION_UNKNOWN

public static final SUTime.Duration DURATION_UNKNOWN

DURATION_NONE

public static final SUTime.Duration DURATION_NONE

MONDAY

public static final SUTime.Time MONDAY

TUESDAY

public static final SUTime.Time TUESDAY

WEDNESDAY

public static final SUTime.Time WEDNESDAY

THURSDAY

public static final SUTime.Time THURSDAY

FRIDAY

public static final SUTime.Time FRIDAY

SATURDAY

public static final SUTime.Time SATURDAY

SUNDAY

public static final SUTime.Time SUNDAY

WEEKDAY

public static final SUTime.Time WEEKDAY

WEEKEND

public static final SUTime.Time WEEKEND

JANUARY

public static final SUTime.Time JANUARY

FEBRUARY

public static final SUTime.Time FEBRUARY

MARCH

public static final SUTime.Time MARCH

APRIL

public static final SUTime.Time APRIL

MAY

public static final SUTime.Time MAY

JUNE

public static final SUTime.Time JUNE

JULY

public static final SUTime.Time JULY

AUGUST

public static final SUTime.Time AUGUST

SEPTEMBER

public static final SUTime.Time SEPTEMBER

OCTOBER

public static final SUTime.Time OCTOBER

NOVEMBER

public static final SUTime.Time NOVEMBER

DECEMBER

public static final SUTime.Time DECEMBER

SPRING_EQUINOX

public static final SUTime.Time SPRING_EQUINOX

SUMMER_SOLSTICE

public static final SUTime.Time SUMMER_SOLSTICE

WINTER_SOLSTICE

public static final SUTime.Time WINTER_SOLSTICE

FALL_EQUINOX

public static final SUTime.Time FALL_EQUINOX

SPRING

public static final SUTime.Time SPRING

SUMMER

public static final SUTime.Time SUMMER

FALL

public static final SUTime.Time FALL

WINTER

public static final SUTime.Time WINTER

NOON

public static final SUTime.PartialTime NOON

MIDNIGHT

public static final SUTime.PartialTime MIDNIGHT

MORNING

public static final SUTime.Time MORNING

AFTERNOON

public static final SUTime.Time AFTERNOON

EVENING

public static final SUTime.Time EVENING

NIGHT

public static final SUTime.Time NIGHT

SUNRISE

public static final SUTime.Time SUNRISE

SUNSET

public static final SUTime.Time SUNSET

DAWN

public static final SUTime.Time DAWN

DUSK

public static final SUTime.Time DUSK

DAYTIME

public static final SUTime.Time DAYTIME

LUNCHTIME

public static final SUTime.Time LUNCHTIME

TEATIME

public static final SUTime.Time TEATIME

DINNERTIME

public static final SUTime.Time DINNERTIME

MORNING_TWILIGHT

public static final SUTime.Time MORNING_TWILIGHT

EVENING_TWILIGHT

public static final SUTime.Time EVENING_TWILIGHT

TWILIGHT

public static final SUTime.TemporalSet TWILIGHT

YESTERDAY

public static final SUTime.RelativeTime YESTERDAY

TOMORROW

public static final SUTime.RelativeTime TOMORROW

TODAY

public static final SUTime.RelativeTime TODAY

TONIGHT

public static final SUTime.RelativeTime TONIGHT

ERA_BC

public static final int ERA_BC

See Also:

Constant Field Values

ERA_AD

public static final int ERA_AD

See Also:

Constant Field Values

ERA_UNKNOWN

public static final int ERA_UNKNOWN

See Also:

Constant Field Values

HALFDAY_AM

public static final int HALFDAY_AM

See Also:

Constant Field Values

HALFDAY_PM

public static final int HALFDAY_PM

See Also:

Constant Field Values

HALFDAY_UNKNOWN

public static final int HALFDAY_UNKNOWN

See Also:

Constant Field Values

HOURLY

public static final SUTime.PeriodicTemporalSet HOURLY

NIGHTLY

public static final SUTime.PeriodicTemporalSet NIGHTLY

DAILY

public static final SUTime.PeriodicTemporalSet DAILY

MONTHLY

public static final SUTime.PeriodicTemporalSet MONTHLY

QUARTERLY

public static final SUTime.PeriodicTemporalSet QUARTERLY

YEARLY

public static final SUTime.PeriodicTemporalSet YEARLY

WEEKLY

public static final SUTime.PeriodicTemporalSet WEEKLY

Method Detail

createTemporal

public static <T extends SUTime.Temporal> T createTemporal(SUTime.StandardTemporalType timeType,
                                                           T temporal)

createTemporal

public static <T extends SUTime.Temporal> T createTemporal(SUTime.StandardTemporalType timeType,
                                                           java.lang.String label,
                                                           T temporal)

createTemporal

public static <T extends SUTime.Temporal> T createTemporal(SUTime.StandardTemporalType timeType,
                                                           java.lang.String label,
                                                           java.lang.String mod,
                                                           T temporal)

parseDateTime

public static SUTime.Time parseDateTime(java.lang.String dateStr)

Converts a string that represents some kind of date into ISO 8601 format and returns it as a SUTime.Time YYYYMMDDThhmmss

Parameters:

dateStr -