1 /* 2 * The contents of this file are subject to the terms 3 * of the Common Development and Distribution License 4 * (the "License"). You may not use this file except 5 * in compliance with the License. 6 * 7 * You can obtain a copy of the license at 8 * glassfish/bootstrap/legal/CDDLv1.0.txt or 9 * https://glassfish.dev.java.net/public/CDDLv1.0.html. 10 * See the License for the specific language governing 11 * permissions and limitations under the License. 12 * 13 * When distributing Covered Code, include this CDDL 14 * HEADER in each file and include the License file at 15 * glassfish/bootstrap/legal/CDDLv1.0.txt. If applicable, 16 * add the following below this CDDL HEADER, with the 17 * fields enclosed by brackets "[]" replaced with your 18 * own identifying information: Portions Copyright [yyyy] 19 * [name of copyright owner] 20 */ 21 package javax.persistence; 22 23 import java.lang.annotation.Target; 24 import java.lang.annotation.Retention; 25 import static java.lang.annotation.ElementType.FIELD; 26 import static java.lang.annotation.ElementType.METHOD; 27 import static java.lang.annotation.RetentionPolicy.RUNTIME; 28 import static javax.persistence.TemporalType.TIMESTAMP; 29 30 /** 31 * This annotation must be specified for persistent fields 32 * or properties of type {@link java.util.Date} and {@link 33 * java.util.Calendar}. It may only be specified for fields 34 * or properties of these types. 35 * 36 * <p> The <code>Temporal</code> annotation may be used in 37 * conjunction with the {@link Basic} annotation. 38 * 39 * <pre> 40 * Example: 41 * 42 * @Temporal(DATE) 43 * protected java.util.Date endDate; 44 * </pre> 45 * 46 * @since Java Persistence 1.0 47 */ 48 @Target({METHOD, FIELD}) 49 @Retention(RUNTIME) 50 public @interface Temporal { 51 52 /** The type used in mapping java.util.Date or java.util.Calendar. */ 53 TemporalType value(); 54 } 55