InTimeRange

See javadoc - uk.gov.gchq.koryphe.impl.predicate.range.InTimeRange

Available since Koryphe version 1.1.0

You can configure the start and end time strings using the following formats:

  • timestamp in milliseconds
  • yyyy/MM
  • yyyy/MM/dd
  • yyyy/MM/dd HH
  • yyyy/MM/dd HH:mm
  • yyyy/MM/dd HH:mm:ss

You can use a space, '-', '/', '_', ':', '|', or '.' to separate the parts.

Examples

In time range with day precision

Java
JSON
Full JSON
Python
final InTimeRange function = new InTimeRange.Builder()
        .start("2017/01/01")
        .end("2017/02/01")
        .build();
{
  "class" : "InTimeRange",
  "start" : "2017/01/01",
  "end" : "2017/02/01"
}
{
  "class" : "uk.gov.gchq.koryphe.impl.predicate.range.InTimeRange",
  "start" : "2017/01/01",
  "end" : "2017/02/01"
}
g.InTimeRange( 
  end="2017/02/01", 
  start="2017/01/01" 
)

Input type:

java.lang.Long

Example inputs:

Input TypeInputResult
java.lang.Long1451606400000false
java.lang.Long1483228800000true
java.lang.Long1483232400000true
java.lang.Long1483315199000true
java.lang.Long1485907200000true
java.lang.Long1485907201000false
nullfalse

In time range with second precision

Java
JSON
Full JSON
Python
final InTimeRange function = new InTimeRange.Builder()
        .start("2017/01/01 01:30:10")
        .end("2017/01/01 01:30:50")
        .build();
{
  "class" : "InTimeRange",
  "start" : "2017/01/01 01:30:10",
  "end" : "2017/01/01 01:30:50"
}
{
  "class" : "uk.gov.gchq.koryphe.impl.predicate.range.InTimeRange",
  "start" : "2017/01/01 01:30:10",
  "end" : "2017/01/01 01:30:50"
}
g.InTimeRange( 
  start="2017/01/01 01:30:10", 
  end="2017/01/01 01:30:50" 
)

Input type:

java.lang.Long

Example inputs:

Input TypeInputResult
java.lang.Long1483234209000false
java.lang.Long1483234210000true
java.lang.Long1483234220000true
java.lang.Long1483234250000true
java.lang.Long1483234251000false
nullfalse

In time range with timestamps

Java
JSON
Full JSON
Python
final InTimeRange function = new InTimeRange.Builder()
        .start("1483315200")
        .end("1485907200")
        .build();
{
  "class" : "InTimeRange",
  "start" : "1483315200",
  "end" : "1485907200"
}
{
  "class" : "uk.gov.gchq.koryphe.impl.predicate.range.InTimeRange",
  "start" : "1483315200",
  "end" : "1485907200"
}
g.InTimeRange( 
  start="1483315200", 
  end="1485907200" 
)

Input type:

java.lang.Long

Example inputs:

Input TypeInputResult
java.lang.Long1483315199false
java.lang.Long1483315200true
java.lang.Long1483316200true
java.lang.Long1485907200true
java.lang.Long1485907201false
nullfalse

In time range exclusive

Java
JSON
Full JSON
Python
final InTimeRange function = new InTimeRange.Builder()
        .start("2017/01/01")
        .end("2017/02/01")
        .startInclusive(false)
        .endInclusive(false)
        .build();
{
  "class" : "InTimeRange",
  "start" : "2017/01/01",
  "end" : "2017/02/01",
  "startInclusive" : false,
  "endInclusive" : false
}
{
  "class" : "uk.gov.gchq.koryphe.impl.predicate.range.InTimeRange",
  "start" : "2017/01/01",
  "end" : "2017/02/01",
  "startInclusive" : false,
  "endInclusive" : false
}
g.InTimeRange( 
  end="2017/02/01", 
  start_inclusive=False, 
  end_inclusive=False, 
  start="2017/01/01" 
)

Input type:

java.lang.Long

Example inputs:

Input TypeInputResult
java.lang.Long1451606400000false
java.lang.Long1483228800000false
java.lang.Long1483232400000true
java.lang.Long1483315199000true
java.lang.Long1485907200000false
java.lang.Long1485907201000false
nullfalse

Within the last week

If the end of the range is not specified then the end of the range is unbounded.

Java
JSON
Full JSON
Python
final InTimeRange function = new InTimeRange.Builder()
        .startOffset(-7L)
                // end is not set - it is unbounded
        .offsetUnit(TimeUnit.DAY)
        .build();
{
  "class" : "InTimeRange",
  "startOffset" : -7,
  "offsetUnit" : "DAY"
}
{
  "class" : "uk.gov.gchq.koryphe.impl.predicate.range.InTimeRange",
  "startOffset" : -7,
  "offsetUnit" : "DAY"
}
g.InTimeRange( 
  offset_unit="DAY", 
  start_offset=-7 
)

Input type:

java.lang.Long

Example inputs:

Input TypeInputResult
java.lang.Long1589124918022false
java.lang.Long1589297718022true
java.lang.Long1589729718022true
java.lang.Long1589816118022true
nullfalse

Exactly 7 hours ago

Java
JSON
Full JSON
Python
final InTimeRange function = new InTimeRange.Builder()
        .startOffset(-7L)
        .endOffset(-6L)
        .endInclusive(false)
        .offsetUnit(TimeUnit.HOUR)
        .build();
{
  "class" : "InTimeRange",
  "startOffset" : -7,
  "endOffset" : -6,
  "endInclusive" : false,
  "offsetUnit" : "HOUR"
}
{
  "class" : "uk.gov.gchq.koryphe.impl.predicate.range.InTimeRange",
  "startOffset" : -7,
  "endOffset" : -6,
  "endInclusive" : false,
  "offsetUnit" : "HOUR"
}
g.InTimeRange( 
  offset_unit="HOUR", 
  end_inclusive=False, 
  end_offset=-6, 
  start_offset=-7 
)

Input type:

java.lang.Long

Example inputs:

Input TypeInputResult
java.lang.Long1589787318088false
java.lang.Long1589790928088true
java.lang.Long1589794508088true
java.lang.Long1589794528088false
java.lang.Long1589816118088false
nullfalse

In date range with time unit microseconds

Java
JSON
Full JSON
Python
final InTimeRange function = new InTimeRange.Builder()
        .start("2017/01/01 01:30:10")
        .end("2017/01/01 01:30:50")
        .timeUnit(TimeUnit.MICROSECOND)
        .build();
{
  "class" : "InTimeRange",
  "start" : "2017/01/01 01:30:10",
  "end" : "2017/01/01 01:30:50",
  "timeUnit" : "MICROSECOND"
}
{
  "class" : "uk.gov.gchq.koryphe.impl.predicate.range.InTimeRange",
  "start" : "2017/01/01 01:30:10",
  "end" : "2017/01/01 01:30:50",
  "timeUnit" : "MICROSECOND"
}
g.InTimeRange( 
  end="2017/01/01 01:30:50", 
  time_unit="MICROSECOND", 
  start="2017/01/01 01:30:10" 
)

Input type:

java.lang.Long

Example inputs:

Input TypeInputResult
java.lang.Long1483234209000000false
java.lang.Long1483234210000000true
java.lang.Long1483234220000000true
java.lang.Long1483234250000000true
java.lang.Long1483234251000000false
nullfalse

results matching ""

    No results matching ""