[
https://issues.apache.org/jira/browse/RYA-392?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16197053#comment-16197053
]
ASF GitHub Bot commented on RYA-392:
------------------------------------
Github user meiercaleb commented on a diff in the pull request:
https://github.com/apache/incubator-rya/pull/237#discussion_r143482605
--- Diff:
common/rya.api/src/main/java/org/apache/rya/api/functions/DateTimeWithinPeriod.java
---
@@ -0,0 +1,128 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */package org.apache.rya.api.functions;
+
+import static com.google.common.base.Preconditions.checkArgument;
+
+import java.time.Duration;
+import java.time.Instant;
+
+import org.openrdf.model.Literal;
+import org.openrdf.model.URI;
+import org.openrdf.model.Value;
+import org.openrdf.model.ValueFactory;
+import org.openrdf.model.datatypes.XMLDatatypeUtil;
+import org.openrdf.model.vocabulary.FN;
+import org.openrdf.model.vocabulary.XMLSchema;
+import org.openrdf.query.algebra.evaluation.ValueExprEvaluationException;
+import org.openrdf.query.algebra.evaluation.function.Function;
+
+/**
+ * This {@link Function} determines whether two {@link
XMLSchema#DATETIME}s occur within a specified period of time of
+ * one another. The method {@link Function#evaluate(ValueFactory,
Value...)} expects four values, where the first two
+ * values are the datetimes, the third value is an integer indicating the
period, and the fourth value is a URI
+ * indicating the time unit of the period. The URI must be of Type
DurationDescription in the OWL-Time ontology (see
+ * <a href
="https://www.w3.org/TR/owl-time/";>https://www.w3.org/TR/owl-time/</a>).
Examples of valid time unit URIs can
+ * be found in the class {@link OWLTime} and below
+ * <ul>
+ * <li>http://www.w3.org/2006/time#days</li>
+ * <li>http://www.w3.org/2006/time#hours</li>
+ * <li>http://www.w3.org/2006/time#minutes</li>
+ * <li>http://www.w3.org/2006/time#seconds</li>
+ * </ul>
+ *
+ */
+public class DateTimeWithinPeriod implements Function {
+
+ private static final String FUNCTION_URI = FN.NAMESPACE +
"dateTimeWithin";
+
+ @Override
+ public String getURI() {
+ return FUNCTION_URI;
+ }
+
+ /**
+ * Determines whether two datetimes occur within a specified period of
time of one another. This method expects four
+ * values, where the first two values are the datetimes, the third
value is an integer indicating the period, and
+ * the fourth value is a URI indicating the time unit of the period.
The URI must be of Type DurationDescription in
+ * the OWL-Time ontology (see <a href
="https://www.w3.org/TR/owl-time/";>https://www.w3.org/TR/owl-time/</a>).
+ * Examples of valid time unit URIs can be found in the class {@link
OWLTime} and below
+ * <ul>
+ * <li>http://www.w3.org/2006/time#days</li>
+ * <li>http://www.w3.org/2006/time#hours</li>
+ * <li>http://www.w3.org/2006/time#minutes</li>
+ * <li>http://www.w3.org/2006/time#seconds</li>
+ * </ul>
+ *
+ * @param valueFactory - factory for creating values
+ * @param values - array of Value arguments for this Function.
+ */
+ @Override
+ public Value evaluate(ValueFactory valueFactory, Value... values)
throws ValueExprEvaluationException {
--- End diff --
Done.
> Temporal Difference Function
> ----------------------------
>
> Key: RYA-392
> URL: https://issues.apache.org/jira/browse/RYA-392
> Project: Rya
> Issue Type: New Feature
> Affects Versions: 3.2.11
> Reporter: Caleb Meier
> Assignee: Caleb Meier
>
> Currently Rya does not provide a Function that determines whether two
> temporal literals are within a given period of time of one another. This is
> extremely useful for filtering on query results that occurred within a fixed
> period of time of a given instant. Currently, if one attempts to form the
> following filter Filter(?time1 - ?time2 < "24"^^xsd:hour), an exception will
> be thrown if ?time1 and ?time2 are date time literals. I propose
> implementing a Function that takes in two temporal literals, an integer and a
> time unit and determines whether the date times are within the prescribed
> period of one another.
--
This message was sent by Atlassian JIRA
(v6.4.14#64029)
