ต้องระบุคำอธิบายประกอบนี้สำหรับเขตข้อมูลหรือคุณสมบัติของชนิดjava.util.Date
และjava.util.Calendar
และอาจระบุเฉพาะสำหรับเขตข้อมูลหรือคุณสมบัติของประเภทเหล่านี้
Temporal
คำอธิบายประกอบอาจถูกนำมาใช้ร่วมกับBasic
คำอธิบายประกอบการId
บันทึกย่อหรือElementCollection
คำอธิบายประกอบ (เมื่อค่าคอลเลกชันองค์ประกอบเป็นเช่นประเภทชั่วคราว
ใน Java API ธรรมดาไม่ได้กำหนดความแม่นยำของเวลาชั่วคราว เมื่อจัดการกับข้อมูลชั่วคราวคุณอาจต้องการอธิบายความแม่นยำที่คาดหวังในฐานข้อมูล ข้อมูลช่วงเวลาอาจมีความแม่นยำ DATE, TIME หรือ TIMESTAMP (เช่นวันที่จริงเฉพาะเวลาหรือทั้งสองอย่าง) ใช้@Temporal
คำอธิบายประกอบเพื่อปรับแต่งสิ่งนั้น
ข้อมูลชั่วคราวคือข้อมูลที่เกี่ยวข้องกับเวลา ตัวอย่างเช่นในระบบจัดการเนื้อหาวันที่สร้างและวันที่อัปเดตล่าสุดของบทความเป็นข้อมูลชั่วคราว ในบางกรณีข้อมูลชั่วคราวต้องการความแม่นยำและคุณต้องการจัดเก็บวันที่ / เวลาที่แม่นยำหรือทั้งสองอย่าง (TIMESTAMP
) ในตารางฐานข้อมูล
ไม่ได้ระบุความแม่นยำชั่วคราวใน Java API หลัก @Temporal
เป็นคำอธิบายประกอบที่แปลงกลับไปมาระหว่างการประทับเวลาและJPA
java.util.Date
นอกจากนี้ยังแปลงtime-stamp
เป็นเวลา ยกตัวอย่างเช่นในตัวอย่างด้านล่างลดลงตามระยะเวลาและมีเพียงวันที่จะเก็บรักษา@Temporal(TemporalType.DATE)
@Temporal(TemporalType.DATE)
private java.util.Date creationDate;
ตาม Javadocs
คำอธิบายประกอบเพื่อประกาศ {@code TemporalType} ที่เหมาะสมในพารามิเตอร์วิธีการสืบค้น โปรดทราบว่าคำอธิบายประกอบนี้สามารถใช้ได้เฉพาะกับพารามิเตอร์ประเภท {@link Date} ที่เป็นค่าเริ่มต้นTemporalType.DATE
[ข้อมูลข้างต้นรวบรวมจากแหล่งต่างๆ]