Package com.nimbusds.jose.util

Class DateUtils

  • @Deprecated
public class DateUtils
extends java.lang.Object
    Deprecated.
    Date utilities. Use DateUtils instead.

    • Method Summary

      All Methods Static Methods Concrete Methods Deprecated Methods 
      Modifier and Type Method Description
      static java.util.Date fromSecondsSinceEpoch​(long time)
      Deprecated.
      Converts the specified Unix epoch time in seconds to a date object.
      static boolean isAfter​(java.util.Date date, java.util.Date reference, long maxClockSkewSeconds)
      Deprecated.
      Check if the specified date is after the specified reference, given the maximum accepted negative clock skew.
      static boolean isBefore​(java.util.Date date, java.util.Date reference, long maxClockSkewSeconds)
      Deprecated.
      Checks if the specified date is before the specified reference, given the maximum accepted positive clock skew.
      static long toSecondsSinceEpoch​(java.util.Date date)
      Deprecated.
      Converts the specified date object to a Unix epoch time in seconds.

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Method Detail

      • toSecondsSinceEpoch

        public static long toSecondsSinceEpoch​(java.util.Date date)
        Deprecated.
        Converts the specified date object to a Unix epoch time in seconds.
        Parameters:
        date - The date. Must not be null.
        Returns:
        The Unix epoch time, in seconds.

      • fromSecondsSinceEpoch

        public static java.util.Date fromSecondsSinceEpoch​(long time)
        Deprecated.
        Converts the specified Unix epoch time in seconds to a date object.
        Parameters:
        time - The Unix epoch time, in seconds. Must not be negative.
        Returns:
        The date.

      • isAfter

        public static boolean isAfter​(java.util.Date date,
                              java.util.Date reference,
                              long maxClockSkewSeconds)
        Deprecated.
        Check if the specified date is after the specified reference, given the maximum accepted negative clock skew.

        Formula: 

         return date + clock_skew > reference
        Example: Ensure a JWT expiration (exp) timestamp is after the current time, with a minute of acceptable clock skew. 
         boolean valid = DateUtils.isAfter(exp, new Date(), 60);
        Parameters:
        date - The date to check. Must not be null.
        reference - The reference date (e.g. the current time). Must not be null.
        maxClockSkewSeconds - The maximum acceptable negative clock skew of the date value to check, in seconds.
        Returns:
        true if the date is before the reference, plus the maximum accepted clock skew, else false.

      • isBefore

        public static boolean isBefore​(java.util.Date date,
                               java.util.Date reference,
                               long maxClockSkewSeconds)
        Deprecated.
        Checks if the specified date is before the specified reference, given the maximum accepted positive clock skew.

        Formula: 

         return date - clock_skew < reference
        Example: Ensure a JWT issued-at (iat) timestamp is before the current time, with a minute of acceptable clock skew. 
         boolean valid = DateUtils.isBefore(iat, new Date(), 60);
        Parameters:
        date - The date to check. Must not be null.
        reference - The reference date (e.g. the current time). Must not be null.
        maxClockSkewSeconds - The maximum acceptable clock skew of the date value to check, in seconds.
        Returns:
        true if the date is before the reference, minus the maximum accepted clock skew, else false.