[
https://issues.apache.org/jira/browse/RYA-392?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16193729#comment-16193729
]
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_r143050918
--- Diff:
common/rya.api/src/main/java/org/apache/rya/api/functions/DateTimeWithinPeriod.java
---
@@ -0,0 +1,121 @@
+/*
+ * 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 org.apache.rya.api.functions.OWLTime.Duration;
+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;
+
+import com.google.common.base.Preconditions;
+
+/**
+ * This {@link Function} determines whether two datetimes 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 DATE_TIME_WITHIN = "dateTimeWithin";
+
+ @Override
+ public String getURI() {
+ return FN.NAMESPACE.toString() + DATE_TIME_WITHIN;
+ }
+
--- 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)
