java.lang.Object

org.aoju.bus.core.date.Formatter

Direct Known Subclasses:: Converter

public class Formatter extends Object

日期格式化和解析 yyyy-MM-dd HH:mm:ss yyyy-MM-dd HH:mm:ss yyyy-MM-dd HH:mm:ss.SSS yyyy-MM-dd HH:mm:ss.SSSSSS yyyy-MM-dd HH:mm:ss.SSSSSSSSS yyyy-MM-dd'T'HH:mm:ss.SSSZ等等，支持毫秒、微秒和纳秒等精确时间

Since:: Java 17+
Author:: Kimi Liu

Constructor Summary

Constructors

Constructor

Description

Formatter()
Method Summary

Modifier and Type

Method

Description

static String

format(long timestamp)

将Unix时间戳转换成日期

static String

format(long timestamp, String format)

将Unix时间戳转换成日期

static long

format(String text)

将指定的日期转换成Unix时间戳

static long

format(String text, String format)

将指定的日期转换成Unix时间戳

static String

format(String text, String srcPattern, String destPattern)

按照给定的通配模式,格式化成相应的时间字符串

static String

format(LocalDateTime localDateTime)

格式化日期时间格式 yyyy-MM-dd HH:mm:ss

static String

format(LocalDateTime localDateTime, String format)

根据特定格式格式化日期

static String

format(TemporalAccessor time, String format)

格式化日期时间为指定格式如果为Month，调用Enum.toString()

static String

format(TemporalAccessor time, DateTimeFormatter formatter)

格式化日期时间为指定格式如果为Month，调用Enum.toString()

static String

format(Calendar calendar, boolean withTime)

将指定Calendar时间格式化为纯中文形式

static String

format(Date date)

按照给定的通配模式 YYYY-MM-DD HH:MM:SS ,将时间格式化成相应的字符串

static String

format(Date date, boolean isUppercase, boolean withTime)

格式化为中文日期格式，如果isUppercase为false 则返回：2018年10月24日，否则,返回二〇一八年十月二十四日

static String

format(Date date, String format)

根据特定格式格式化日期

static String

format(Date date, String format, String timeZone)

根据特定格式格式化日期

static String

format(Date date, DateFormat format)

根据特定格式格式化日期

static String

format(Date date, DateTimeFormatter format)

根据特定格式格式化日期

static String

format(Date date, DatePrinter format)

根据特定格式格式化日期

static String

formatBetween(long betweenMs)

格式化日期间隔输出,精确到毫秒

static String

formatBetween(long betweenMs, Fields.Units units)

格式化日期间隔输出

static String

formatBetween(Date beginDate, Date endDate)

格式化日期间隔输出,精确到毫秒

static String

formatBetween(Date beginDate, Date endDate, Fields.Units units)

格式化日期间隔输出

static String

formatDate(Date date)

格式化日期部分(不包括时间) 格式 yyyy-MM-dd

static String

formatDate(Date date, boolean isHttp)

格式化日期部分(不包括时间) 格式 yyyy-MM-dd

static String

formatTime(Date date)

格式化时间格式 HH:mm:ss

static String

getShotName(TimeUnit unit)

获取时长单位简写

static SimpleDateFormat

newSimpleFormat(String pattern)

创建SimpleDateFormat，注意此对象非线程安全此对象默认为严格格式模式，即parse时如果格式不正确会报错

static SimpleDateFormat

newSimpleFormat(String pattern, Locale locale, TimeZone timeZone)

创建SimpleDateFormat，注意此对象非线程安全此对象默认为严格格式模式，即parse时如果格式不正确会报错

static DateTime

parse(CharSequence text)

将日期字符串转换为DateTime对象，格式： yyyy-MM-dd HH:mm:ss yyyy/MM/dd HH:mm:ss yyyy.MM.dd HH:mm:ss yyyy年MM月dd日 HH时mm分ss秒 yyyy-MM-dd yyyy/MM/dd yyyy.MM.dd HH:mm:ss HH时mm分ss秒 yyyy-MM-dd HH:mm yyyy-MM-dd HH:mm:ss.SSS yyyy-MM-dd HH:mm:ss.SSSSSS yyyyMMddHHmmss yyyyMMddHHmmssSSS yyyyMMdd EEE, dd MMM yyyy HH:mm:ss z EEE MMM dd HH:mm:ss zzz yyyy yyyy-MM-dd'T'HH:mm:ss'Z' yyyy-MM-dd'T'HH:mm:ss.SSS'Z' yyyy-MM-dd'T'HH:mm:ssZ yyyy-MM-dd'T'HH:mm:ss.SSSZ

static DateTime

parse(CharSequence text, String format)

将特定格式的日期转换为Date对象

static DateTime

parse(CharSequence text, String format, Locale locale)

将特定格式的日期转换为Date对象

static DateTime

parse(CharSequence text, DateFormat dateFormat)

构建DateTime对象

static DateTime

parse(CharSequence text, DateTimeFormatter formatter)

构建DateTime对象

static DateTime

parse(CharSequence text, PositionDateParser parser)

构建DateTime对象

static DateTime

parse(CharSequence text, PositionDateParser parser, boolean lenient)

构建DateTime对象

static DateTime

parse(String text, String... format)

通过给定的日期格式解析日期时间字符串传入的日期格式会逐个尝试，直到解析成功，返回DateTime对象，否则抛出InternalException异常

static Calendar

parseByPatterns(CharSequence text, boolean lenient, PositionDateParser parser)

使用指定DateParser解析字符串为Calendar

static Calendar

parseByPatterns(String text, String... pattern)

通过给定的日期格式解析日期时间字符串传入的日期格式会逐个尝试，直到解析成功，返回Calendar对象

static Calendar

parseByPatterns(String text, Locale locale, boolean lenient, String... pattern)

通过给定的日期格式解析日期时间字符串传入的日期格式会逐个尝试，直到解析成功，返回Calendar对象

static Calendar

parseByPatterns(String text, Locale locale, String... pattern)

通过给定的日期格式解析日期时间字符串传入的日期格式会逐个尝试，直到解析成功，返回Calendar对象

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details
- Formatter
  
  public Formatter()
Method Details
- format
  
  public static String format(Date date)
  
  按照给定的通配模式 YYYY-MM-DD HH:MM:SS ,将时间格式化成相应的字符串
  
  Parameters:
  
  date - 待格式化的时间
  
  Returns:
  
  格式化成功返回成功后的字符串, 失败返回null
- format
  
  public static String format(Date date, String format)
  
  根据特定格式格式化日期
  
  Parameters:
  
  date - 被格式化的日期
  
  format - 日期格式,常用格式见： Fields
  
  Returns:
  
  格式化后的字符串
- format
  
  public static String format(Date date, DatePrinter format)
  
  根据特定格式格式化日期
  
  Parameters:
  
  date - 被格式化的日期
  
  format - DatePrinter 或 FormatBuilder
  
  Returns:
  
  格式化后的字符串
- format
  
  public static String format(Date date, DateFormat format)
  
  根据特定格式格式化日期
  
  Parameters:
  
  date - 被格式化的日期
  
  format - SimpleDateFormat
  
  Returns:
  
  格式化后的字符串
- format
  
  public static String format(Date date, DateTimeFormatter format)
  
  根据特定格式格式化日期
  
  Parameters:
  
  date - 被格式化的日期
  
  format - SimpleDateFormat Fields.NORM_DATETIME_FORMAT
  
  Returns:
  
  格式化后的字符串
- format
  
  public static String format(Date date, String format, String timeZone)
  
  根据特定格式格式化日期
  
  Parameters:
  
  date - 被格式化的日期
  
  format - 日期格式,常用格式见： Fields
  
  timeZone - 时区
  
  Returns:
  
  格式化后的字符串
- format
  
  public static String format(String text, String srcPattern, String destPattern)
  
  按照给定的通配模式,格式化成相应的时间字符串
  
  Parameters:
  
  text - 原始时间字符串
  
  srcPattern - 原始时间通配符
  
  destPattern - 格式化成的时间通配符
  
  Returns:
  
  格式化成功返回成功后的字符串, 失败返回""
- format
  
  public static long format(String text)
  
  将指定的日期转换成Unix时间戳
  
  Parameters:
  
  text - 需要转换的日期 yyyy-MM-dd HH:mm:ss
  
  Returns:
  
  long 时间戳
- format
  
  public static String format(long timestamp)
  
  将Unix时间戳转换成日期
  
  Parameters:
  
  timestamp - 时间戳
  
  Returns:
  
  String 日期字符串
- format
  
  public static String format(long timestamp, String format)
  
  将Unix时间戳转换成日期
  
  Parameters:
  
  timestamp - 时间戳
  
  format - 格式
  
  Returns:
  
  String 日期字符串
- format
  
  public static long format(String text, String format)
  
  将指定的日期转换成Unix时间戳
  
  Parameters:
  
  text - 需要转换的日期
  
  format - 格式
  
  Returns:
  
  long 时间戳
- format
  
  public static String format(LocalDateTime localDateTime)
  
  格式化日期时间格式 yyyy-MM-dd HH:mm:ss
  
  Parameters:
  
  localDateTime - 被格式化的日期
  
  Returns:
  
  格式化后的字符串
- format
  
  public static String format(LocalDateTime localDateTime, String format)
  
  根据特定格式格式化日期
  
  Parameters:
  
  localDateTime - 被格式化的日期
  
  format - 日期格式，常用格式见： Fields
  
  Returns:
  
  格式化后的字符串
- format
  
  public static String format(TemporalAccessor time, DateTimeFormatter formatter)
  
  格式化日期时间为指定格式如果为Month，调用Enum.toString()
  
  Parameters:
  
  time - TemporalAccessor
  
  formatter - 日期格式化器，预定义的格式见：DateTimeFormatter
  
  Returns:
  
  格式化后的字符串
- format
  
  public static String format(TemporalAccessor time, String format)
  
  格式化日期时间为指定格式如果为Month，调用Enum.toString()
  
  Parameters:
  
  time - TemporalAccessor
  
  format - 日期格式
  
  Returns:
  
  格式化后的字符串
- format
  
  public static String format(Date date, boolean isUppercase, boolean withTime)
  
  格式化为中文日期格式，如果isUppercase为false 则返回：2018年10月24日，否则,返回二〇一八年十月二十四日
  
  Parameters:
  
  date - 被格式化的日期
  
  isUppercase - 是否采用大写形式
  
  withTime - 是否包含时间部分
  
  Returns:
  
  中文日期字符串
- format
  public static String format(Calendar calendar, boolean withTime)
  
  将指定Calendar时间格式化为纯中文形式
  2018-02-24 12:13:14 转换为二〇一八年二月二十四日（withTime为false） 2018-02-24 12:13:14 转换为二〇一八年二月二十四日一十二时一十三分一十四秒（withTime为true）
  
  Parameters:
  
  calendar - Calendar
  
  withTime - 是否包含时间部分
  
  Returns:
  
  格式化后的字符串
- formatDate
  
  public static String formatDate(Date date)
  
  格式化日期部分(不包括时间) 格式 yyyy-MM-dd
  
  Parameters:
  
  date - 被格式化的日期
  
  Returns:
  
  格式化后的字符串
- formatDate
  
  public static String formatDate(Date date, boolean isHttp)
  
  格式化日期部分(不包括时间) 格式 yyyy-MM-dd
  
  Parameters:
  
  date - 被格式化的日期
  
  isHttp - 是否http格式
  
  Returns:
  
  格式化后的字符串
- formatTime
  
  public static String formatTime(Date date)
  
  格式化时间格式 HH:mm:ss
  
  Parameters:
  
  date - 被格式化的日期
  
  Returns:
  
  格式化后的字符串
- formatBetween
  
  public static String formatBetween(Date beginDate, Date endDate, Fields.Units units)
  
  格式化日期间隔输出
  
  Parameters:
  
  beginDate - 起始日期
  
  endDate - 结束日期
  
  units - 级别,按照天、小时、分、秒、毫秒分为5个等级
  
  Returns:
  
  XX天XX小时XX分XX秒
- formatBetween
  
  public static String formatBetween(Date beginDate, Date endDate)
  
  格式化日期间隔输出,精确到毫秒
  
  Parameters:
  
  beginDate - 起始日期
  
  endDate - 结束日期
  
  Returns:
  
  XX天XX小时XX分XX秒
- formatBetween
  
  public static String formatBetween(long betweenMs, Fields.Units units)
  
  格式化日期间隔输出
  
  Parameters:
  
  betweenMs - 日期间隔
  
  units - 级别,按照天、小时、分、秒、毫秒分为5个等级
  
  Returns:
  
  XX天XX小时XX分XX秒XX毫秒
- formatBetween
  
  public static String formatBetween(long betweenMs)
  
  格式化日期间隔输出,精确到毫秒
  
  Parameters:
  
  betweenMs - 日期间隔
  
  Returns:
  
  XX天XX小时XX分XX秒XX毫秒
- parse
  
  public static DateTime parse(CharSequence text, DateFormat dateFormat)
  
  构建DateTime对象
  
  Parameters:
  
  text - Date字符串
  
  dateFormat - 格式化器 SimpleDateFormat
  
  Returns:
  
  DateTime对象
- parse
  
  public static DateTime parse(CharSequence text, PositionDateParser parser)
  
  构建DateTime对象
  
  Parameters:
  
  text - Date字符串
  
  parser - 格式化器,FormatBuilder
  
  Returns:
  
  DateTime对象
- parse
  
  public static DateTime parse(CharSequence text, PositionDateParser parser, boolean lenient)
  
  构建DateTime对象
  
  Parameters:
  
  text - Date字符串
  
  parser - 格式化器,FormatBuilder
  
  lenient - 是否宽容模式
  
  Returns:
  
  DateTime对象
- parse
  
  public static DateTime parse(CharSequence text, DateTimeFormatter formatter)
  
  构建DateTime对象
  
  Parameters:
  
  text - Date字符串
  
  formatter - 格式化器,DateTimeFormatter
  
  Returns:
  
  DateTime对象
- parse
  
  public static DateTime parse(CharSequence text, String format)
  
  将特定格式的日期转换为Date对象
  
  Parameters:
  
  text - 特定格式的日期
  
  format - 格式，例如yyyy-MM-dd
  
  Returns:
  
  日期对象
- parse
  
  public static DateTime parse(CharSequence text, String format, Locale locale)
  
  将特定格式的日期转换为Date对象
  
  Parameters:
  
  text - 特定格式的日期
  
  format - 格式，例如yyyy-MM-dd
  
  locale - 区域信息
  
  Returns:
  
  日期对象
- parse
  
  public static DateTime parse(String text, String... format) throws InternalException
  
  通过给定的日期格式解析日期时间字符串传入的日期格式会逐个尝试，直到解析成功，返回DateTime对象，否则抛出InternalException异常
  
  Parameters:
  
  text - 日期时间字符串，非空
  
  format - 需要尝试的日期时间格式数组，非空, 见SimpleDateFormat
  
  Returns:
  
  解析后的Date
  
  Throws:
  
  IllegalArgumentException - if the date string or pattern array is null
  
  InternalException - if none of the date patterns were suitable
- parse
  public static DateTime parse(CharSequence text)
  
  将日期字符串转换为DateTime对象，格式：
  
  yyyy-MM-dd HH:mm:ss
  
  yyyy/MM/dd HH:mm:ss
  
  yyyy.MM.dd HH:mm:ss
  
  yyyy年MM月dd日 HH时mm分ss秒
  
  yyyy-MM-dd
  
  yyyy/MM/dd
  
  yyyy.MM.dd
  
  HH:mm:ss
  
  HH时mm分ss秒
  
  yyyy-MM-dd HH:mm
  
  yyyy-MM-dd HH:mm:ss.SSS
  
  yyyy-MM-dd HH:mm:ss.SSSSSS
  
  yyyyMMddHHmmss
  
  yyyyMMddHHmmssSSS
  
  yyyyMMdd
  
  EEE, dd MMM yyyy HH:mm:ss z
  
  EEE MMM dd HH:mm:ss zzz yyyy
  
  yyyy-MM-dd'T'HH:mm:ss'Z'
  
  yyyy-MM-dd'T'HH:mm:ss.SSS'Z'
  
  yyyy-MM-dd'T'HH:mm:ssZ
  
  yyyy-MM-dd'T'HH:mm:ss.SSSZ
  
  Parameters:
  
  text - 日期字符串
  
  Returns:
  
  日期
- parseByPatterns
  
  public static Calendar parseByPatterns(String text, String... pattern)
  
  通过给定的日期格式解析日期时间字符串传入的日期格式会逐个尝试，直到解析成功，返回Calendar对象
  
  Parameters:
  
  text - 日期时间字符串，非空
  
  pattern - 需要尝试的日期时间格式数组，非空, 见SimpleDateFormat
  
  Returns:
  
  解析后的 Calendar
- parseByPatterns
  
  public static Calendar parseByPatterns(String text, Locale locale, String... pattern)
  
  通过给定的日期格式解析日期时间字符串传入的日期格式会逐个尝试，直到解析成功，返回Calendar对象
  
  Parameters:
  
  text - 日期时间字符串，非空
  
  locale - 地区，当为null时使用Locale.getDefault()
  
  pattern - 需要尝试的日期时间格式数组，非空, 见SimpleDateFormat
  
  Returns:
  
  解析后的 Calendar
- parseByPatterns
  
  public static Calendar parseByPatterns(CharSequence text, boolean lenient, PositionDateParser parser)
  
  使用指定DateParser解析字符串为Calendar
  
  Parameters:
  
  text - 日期字符串
  
  lenient - 是否宽容模式
  
  parser - DateParser
  
  Returns:
  
  解析后的 Calendar，解析失败返回null
- parseByPatterns
  public static Calendar parseByPatterns(String text, Locale locale, boolean lenient, String... pattern)
  
  通过给定的日期格式解析日期时间字符串传入的日期格式会逐个尝试，直到解析成功，返回Calendar对象
  
  Parameters:
  
  text - 日期时间字符串，非空
  
  locale - 地区，当为null时使用Locale.getDefault()
  
  lenient - 日期时间解析是否使用严格模式
  
  pattern - 需要尝试的日期时间格式数组，非空
  
  Returns:
  
  解析后的 Calendar
  
  See Also:
  
  Calendar.isLenient()
- newSimpleFormat
  
  public static SimpleDateFormat newSimpleFormat(String pattern)
  
  创建SimpleDateFormat，注意此对象非线程安全此对象默认为严格格式模式，即parse时如果格式不正确会报错
  
  Parameters:
  
  pattern - 表达式
  
  Returns:
  
  SimpleDateFormat
- newSimpleFormat
  
  public static SimpleDateFormat newSimpleFormat(String pattern, Locale locale, TimeZone timeZone)
  
  创建SimpleDateFormat，注意此对象非线程安全此对象默认为严格格式模式，即parse时如果格式不正确会报错
  
  Parameters:
  
  pattern - 表达式
  
  locale - Locale，null表示默认
  
  timeZone - TimeZone，null表示默认
  
  Returns:
  
  SimpleDateFormat
- getShotName
  
  public static String getShotName(TimeUnit unit)
  
  获取时长单位简写
  
  Parameters:
  
  unit - 单位
  
  Returns:
  
  单位简写名称

Class Formatter

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Details

Formatter

Method Details

format

format

format

format

format

format

format

format

format

format

format

format

format

format

format

format

format

formatDate

formatDate

formatTime

formatBetween

formatBetween

formatBetween

formatBetween

parse

parse

parse

parse

parse

parse

parse

parse

parseByPatterns

parseByPatterns

parseByPatterns

parseByPatterns

newSimpleFormat

newSimpleFormat

getShotName