edu.stanford.nlp.time

Class Timex

java.lang.Object

edu.stanford.nlp.time.Timex

All Implemented Interfaces:

java.io.Serializable

public class Timex
extends java.lang.Object
implements java.io.Serializable

Stores one TIMEX3 expression. This class is used for both TimeAnnotator and GUTimeAnnotator for storing information for TIMEX3 tags.

Example text with TIMEX3 annotation:
In Washington <TIMEX3 tid="t1" TYPE="DATE" VAL="PRESENT_REF" temporalFunction="true" valueFromFunction="tf1" anchorTimeID="t0">today</TIMEX3>, the Federal Aviation Administration released air traffic control tapes from the night the TWA Flight eight hundred went down.

TIMEX3 specification:

 attributes ::= tid type [functionInDocument] [beginPoint] [endPoint]
                [quant] [freq] [temporalFunction] (value | valueFromFunction)
                [mod] [anchorTimeID] [comment]

 tid ::= ID
   {tid ::= TimeID
    TimeID ::= t<integer>}
 type ::= 'DATE' | 'TIME' | 'DURATION' | 'SET'
 beginPoint ::= IDREF
    {beginPoint ::= TimeID}
 endPoint ::= IDREF
    {endPoint ::= TimeID}
 quant ::= CDATA
 freq ::= Duration
 functionInDocument ::= 'CREATION_TIME' | 'EXPIRATION_TIME' | 'MODIFICATION_TIME' |
                        'PUBLICATION_TIME' | 'RELEASE_TIME'| 'RECEPTION_TIME' |
                        'NONE' {default, if absent, is 'NONE'}
 temporalFunction ::= 'true' | 'false' {default, if absent, is 'false'}
    {temporalFunction ::= boolean}
 value ::= Duration | Date | Time | WeekDate | WeekTime | Season | PartOfYear | PaPrFu
 valueFromFunction ::= IDREF
    {valueFromFunction ::= TemporalFunctionID
 TemporalFunctionID ::= tf<integer>}
 mod ::= 'BEFORE' | 'AFTER' | 'ON_OR_BEFORE' | 'ON_OR_AFTER' |'LESS_THAN' | 'MORE_THAN' |
         'EQUAL_OR_LESS' | 'EQUAL_OR_MORE' | 'START' | 'MID' | 'END' | 'APPROX'
 anchorTimeID ::= IDREF
   {anchorTimeID ::= TimeID}
 comment ::= CDATA
 

References
Guidelines: http://www.timeml.org/tempeval2/tempeval2-trial/guidelines/timex3guidelines-072009.pdf
Specifications: http://www.timeml.org/site/publications/timeMLdocs/timeml_1.2.1.html#timex3
XSD: http://www.timeml.org/timeMLdocs/TimeML.xsd

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Timex.Range

Constructor Summary

Constructors

Constructor and Description
Timex()
Timex(org.w3c.dom.Element element)
Timex(java.lang.String val)
Timex(java.lang.String type, java.lang.String val)
Timex(java.lang.String type, java.lang.String val, java.lang.String altVal, java.lang.String tid, java.lang.String text, int beginPoint, int endPoint)

Method Summary

Modifier and Type	Method and Description
java.lang.String	altVal()
int	beginPoint()
int	endPoint()
boolean	equals(java.lang.Object o)
static Timex	fromMap(java.lang.String text, java.util.Map<java.lang.String,java.lang.String> map)
static Timex	fromXml(java.lang.String xml)
java.util.Calendar	getDate() Gets the Calendar matching the year, month and day of this Timex.
Pair<java.util.Calendar,java.util.Calendar>	getRange() Gets two Calendars, marking the beginning and ending of this Timex's range.
Pair<java.util.Calendar,java.util.Calendar>	getRange(Timex documentTime) Gets two Calendars, marking the beginning and ending of this Timex's range.
int	hashCode()
Timex.Range	range()
java.lang.String	text()
java.lang.String	tid()
java.lang.String	timexType()
java.lang.String	toString()
org.w3c.dom.Element	toXmlElement()
java.lang.String	value()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Timex

public Timex()

Timex

public Timex(org.w3c.dom.Element element)

Timex

public Timex(java.lang.String val)

Timex

public Timex(java.lang.String type,
             java.lang.String val)

Timex

public Timex(java.lang.String type,
             java.lang.String val,
             java.lang.String altVal,
             java.lang.String tid,
             java.lang.String text,
             int beginPoint,
             int endPoint)

Method Detail

value

public java.lang.String value()

altVal

public java.lang.String altVal()

text

public java.lang.String text()

timexType

public java.lang.String timexType()

tid

public java.lang.String tid()

range

public Timex.Range range()

beginPoint

public int beginPoint()

endPoint

public int endPoint()

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

toXmlElement

public org.w3c.dom.Element toXmlElement()

fromXml

public static Timex fromXml(java.lang.String xml)

fromMap

public static Timex fromMap(java.lang.String text,
                            java.util.Map<java.lang.String,java.lang.String> map)

getDate

public java.util.Calendar getDate()

Gets the Calendar matching the year, month and day of this Timex.

Returns:

The matching Calendar.

getRange

public Pair<java.util.Calendar,java.util.Calendar> getRange()

Gets two Calendars, marking the beginning and ending of this Timex's range.

Returns:

The begin point and end point Calendars.

getRange

public Pair<java.util.Calendar,java.util.Calendar> getRange(Timex documentTime)

Gets two Calendars, marking the beginning and ending of this Timex's range.

Parameters:

documentTime - The time the document containing this Timex was written. (Not necessary for resolving all Timex expressions. This may be null, but then relative time expressions cannot be resolved.)

Returns:

The begin point and end point Calendars.