Module pro.eng.yui.YuiFramework
Package pro.eng.yui.yuiframe.utils

Interface IDateUtil

public interface IDateUtil
Define common Date/Calendar operations
Since:
1.0.0
Version:
1.1.0
Author:
yui-KITAMURA

  • Method Details

    • now

      @Contract(" -> new") Calendar now()
      Get Calendar instance of current DateTime.
      Returns:
      instance of current DateTime

    • toDate

      @Contract("null -> null; !null -> new") Date toDate(Calendar calendar)
      Convert Calendar to Date null-safe
      Parameters:
      calendar - original instance of Calendar
      Returns:
      the Date instance that has same timestamp with parameter

    • toCal

      @Contract("null -> null; !null-> new") Calendar toCal(Date date)
      Convert Date to Calendar null-safe
      Parameters:
      date - original instance of Date
      Returns:
      the Calendar instance that has same timestamp with parameter

    • toStr

      @Contract("null, null -> fail; null, _ -> null; !null, _ -> new") String toStr(Calendar calendar, IDateUtil.Formats format)
      String formatter with IDateUtil.Formats
      Parameters:
      calendar - Calendar instance to be formatted
      format - the output format that you want to get
      Returns:
      the string value which the argument of calendar formatted with selected format

    • toStr

      @Contract("null, null -> fail; null, _ -> null; !null, _ -> new") String toStr(Date date, IDateUtil.Formats format)
      String formatter with IDateUtil.Formats
      Parameters:
      date - Date instance to be formatted
      format - the output format that you want to get
      Returns:
      the string value which the argument of date formatted with selected format

    • fromStr

      @Contract("null, null -> fail; null, _ -> null; !null, _ -> new") Calendar fromStr(String input, IDateUtil.Formats format)
      Convert String to Calendar with format
      Parameters:
      input - convert target text
      format - the text format
      Returns:
      the Calendar instance which has the time given with the input
      Throws:
      IllegalArgumentException - when failed to convert
      Since:
      1.1.0

    • toTS

      @Contract("null -> null; !null -> new") Timestamp toTS(Calendar calendar)
      Convert Calendar to Timestamp
      Parameters:
      calendar - original Calendar instance
      Returns:
      the Timestamp instance that has same DateTime with argument

    • toTS

      @Contract("null -> null; !null -> new") Timestamp toTS(Date date)
      Convert Date to Timestamp
      Parameters:
      date - original Date instance
      Returns:
      the Timestamp instance that has same DateTime with argument