Java UUID timestamp() Method

---

---

Description

The Java UUID timestamp() method is used to return the timestamp value associated with this UUID.

Declaration

Following is the declaration for java.util.UUID.timestamp() method.

public long timestamp()

Parameters

NA

Return Value

The method call returns the timestamp value associated with this UUID.

Exception

UnsupportedOperationException − This exception is thrown if this UUID is not a version 1 UUID.

Getting Timestamp of a UUID generated using Standard Formatted String Example

The following example shows the usage of Java UUID timestamp() method to the timestamp value of this UUID. We've created a UUID object using a given string. Then we've printed the timestamp value of this UUID object using timestamp() method.

package com.tutorialspoint;

import java.util.UUID;

public class UUIDDemo {
   public static void main(String[] args) {

      // creating UUID      
      UUID x = UUID.fromString("38400000-8cf0-11bd-b23e-10b96e4ef00d");

      // getting timestamp value
      System.out.println("timestamp value: "+x.timestamp());    
   }    
}

Output

Let us compile and run the above program, this will produce the following result.

timestamp value: 125411328000000000

Getting Timestamp of a Random UUID generated Example

The following example shows usage of Java UUID timestamp() method to get the timestamp value associated with this UUID which is not supported. We've created a UUID object using randomUUID() method. Then we tried getting the timestamp value associated with the UUID object using timestamp() method. It throws exception which we've captured and printed.

package com.tutorialspoint;

import java.util.UUID;

public class UUIDDemo {
   public static void main(String[] args) {

      // creating UUID      
      UUID x = UUID.randomUUID();

      try {
         // getting timestamp value
         System.out.println("timestamp value: "+x.timestamp());
      } catch(Exception e) {
         e.printStackTrace();
      }
   }    
}

Output

Let us compile and run the above program, this will produce the following result.

java.lang.UnsupportedOperationException: Not a time-based UUID
	at java.base/java.util.UUID.timestamp(UUID.java:312)
	at com.tutorialspoint.UUIDDemo.main(UUIDDemo.java:13)

Getting Timestamp of a UUID generated using Bytes Example

The following example shows usage of Java UUID timestamp() method to get the timestamp value associated with this UUID which is not supported. We've created a UUID object using nameUUIDFromBytes() method. Then we tried getting the timestamp value associated with the UUID object using timestamp() method. It throws exception which we've captured and printed.

package com.tutorialspoint;

import java.util.UUID;

public class UUIDDemo {
   public static void main(String[] args) {

      // creating byte array 
      byte[] nbyte = {10,20,30};

      // creating UUID from byte     
      UUID uid = UUID.nameUUIDFromBytes(nbyte);

      try {
         // getting timestamp value
         System.out.println("timestamp value: "+uid.timestamp());
      } catch(Exception e) {
         e.printStackTrace();
      }
   }    
}

Output

Let us compile and run the above program, this will produce the following result.

java.lang.UnsupportedOperationException: Not a time-based UUID
	at java.base/java.util.UUID.timestamp(UUID.java:312)
	at com.tutorialspoint.UUIDDemo.main(UUIDDemo.java:16)