harmony-utils之DateUtil，日期工具類

harmony-utils 簡介與說明

harmony-utils 一款功能豐富且極易上手的HarmonyOS工具庫，借助眾多實用工具類，致力于助力開發者迅速構建鴻蒙應用。其封裝的工具涵蓋了APP、設備、屏幕、授權、通知、線程間通信、彈框、吐司、生物認證、用戶首選項、拍照、相冊、掃碼、文件、日志、異常捕獲、字符、字符串、數字、集合、日期、隨機、base64、加密、解密、JSON等一系列的功能和作，能夠滿足各種不同的開發需求。
picker_utils 是harmony-utils拆分出來的一個子庫，包含 PickerUtil、PhotoHelper、ScanUtil。

下載安裝
ohpm i @pura/harmony-utils
ohpm i @pura/picker_utils

//全局初始化方法，在UIAbility的onCreate方法中初始化 AppUtil.init()
 onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
   AppUtil.init(this.context);
 }

API方法與使用

getFormatDate 獲取格式化日期，將傳入的日期格式化為Date

let date1 = DateUtil.getFormatDate(1716181651533);
let date2 = DateUtil.getFormatDate("2024-05-21");
let date3 = DateUtil.getFormatDate("2024-05-20 13:07:45");
let date4 = DateUtil.getFormatDate("2024年05月20日 13時07分45秒");
let date5 = DateUtil.getFormatDate("2024年05月20日");
let date6 = DateUtil.getFormatDate("2024/05/20");
let date7 = DateUtil.getFormatDate(new Date());

getFormatDateStr 獲取格式化日期，將傳入的日期格式化為指定格式的字符串

let todayStr1 = DateUtil.getFormatDateStr(1716181651533);
let todayStr2 = DateUtil.getFormatDateStr(DateUtil.getTodayTime(), DATE_FORMAT11);
let todayStr3 = DateUtil.getFormatDateStr("2024-05-20 13:07:45", DATE_FORMAT17);
let todayStr4 = DateUtil.getFormatDateStr("2024年05月20日 13時07分45秒", DATE_FORMAT16);
let todayStr5 = DateUtil.getFormatDateStr("2024年05月20日");
let todayStr6 = DateUtil.getFormatDateStr("2024/05/20");
let todayStr7 = DateUtil.getFormatDateStr(new Date());

getToday 獲取今天的日期

let today = DateUtil.getToday();

getTodayTime 獲取今天的時間戳

let todayTime = DateUtil.getTodayTime();

getTodayStr 獲取今天的時間，字符串類型

let todayStr1 = DateUtil.getTodayStr();
let todayStr2 = DateUtil.getTodayStr("yyyy-MM-dd HH:mm");
let todayStr3 = DateUtil.getTodayStr("yyyy-MM-dd HH");
let todayStr4 = DateUtil.getTodayStr("yyyy-MM-dd");
let todayStr5 = DateUtil.getTodayStr("yyyy/MM/dd");
let todayStr6 = DateUtil.getTodayStr("yyyy年MM月dd日");
let todayStr7 = DateUtil.getTodayStr("yyyy年MM月dd日 HH時mm分ss秒");

isToday 判斷日期是否是今天

let today = DateUtil.getToday();
let todayTime = 1723983090245;
let todayStr1 = "2024年8月18日";
let b1 = DateUtil.isToday(today);
let b2 = DateUtil.isToday(todayTime);
let b3 = DateUtil.isToday(todayStr1);

getNowYear 獲取當前年

let nowYear = DateUtil.getNowYear();

getNowMonth 獲取當前月

let nowMonth = DateUtil.getNowMonth();

getNowDay 獲取當前日

let nowDay = DateUtil.getNowDay();

isLeapYear 判斷是否是閏年

let isLeapYear1 = DateUtil.isLeapYear();
let isLeapYear2 = DateUtil.isLeapYear(1999);
let isLeapYear3 = DateUtil.isLeapYear(2000);
let isLeapYear4 = DateUtil.isLeapYear(2026);

getDaysByYear 獲取指定年份的天數

let day1 = DateUtil.getDaysByYear(2024);

getDaysByMonth 獲取指定月份的天數

let day2 = DateUtil.getDaysByMonth(2024, 8);

isSameYear 判斷兩個日期是否是同一年

let isSameYear = DateUtil.isSameYear("2024-8-18", DateUtil.getToday());

isSameMonth 判斷兩個日期是否是同一月

let isSameMonth = DateUtil.isSameMonth("2024-8-1", "2024年08月18日");

isSameWeek 判斷兩個日期是否是同一周

let isSameWeek = DateUtil.isSameWeek("2024-8-12", "2024/08/18");

isSameDay 判斷是否是同一天

let isSameDay = DateUtil.isSameDay("2024-08-18", "2024年08月18日");

isWeekend 判斷指定的日期在日歷中是否為周末

let b1 = DateUtil.isWeekend("2024-08-12");
let b2 = DateUtil.isWeekend("2024-08-15");
let b3 = DateUtil.isWeekend("2024-08-17");
let b4 = DateUtil.isWeekend(DateUtil.getToday());

compareDays 比較指定日期相差的天數

let diff1 = DateUtil.compareDays("2024-8-08", DateUtil.getToday());
let diff2 = DateUtil.compareDays("2024-8-21", "2024年08月18日");

compareDate 比較指定日期相差的毫秒數

let diff3 = DateUtil.compareDate("2024-8-22", "2024/08/18");
let diff4 = DateUtil.compareDate("2024-08-18", DateUtil.getToday());

getAmountDay 獲取前幾天日期或后幾天日期

let date1 = DateUtil.getAmountDay(DateUtil.getToday(), 2);
let date2 = DateUtil.getAmountDay("2024-8-08", -2);

getAmountDayStr 獲取前幾天日期或后幾天日期,返回字符串

let date3 = DateUtil.getAmountDayStr("2024-8-8", 3);
let date4 = DateUtil.getAmountDayStr(DateUtil.getToday(), -3);

getBeforeDay 獲取前一天日期

let date1 = DateUtil.getBeforeDay(DateUtil.getToday());

getBeforeDayStr 獲取前一天日期,返回字符串

let date2 = DateUtil.getBeforeDayStr("2024-8-08");

getAfterDay 獲取后一天日期

let date3 = DateUtil.getAfterDay(DateUtil.getToday());

getAfterDayStr 獲取后一天日期,返回字符串

let date4 = DateUtil.getAfterDayStr("2024-8-8");

getWeekOfMonth 獲取給定日期是當月的第幾周

let n1 = DateUtil.getWeekOfMonth(DateUtil.getToday());

getWeekDay 獲取給定的日期是星期幾

let n2 = DateUtil.getWeekDay("2024-8-08");

getLastDayOfMonth 獲取給定年份和月份的最后一天是幾號

let n3 = DateUtil.getLastDayOfMonth(2024, 8);

getFormatTime 格式化時間日期字符串（DateTimeFormat）

let n1 = DateUtil.getFormatTime(DateUtil.getToday());
let n2 = DateUtil.getFormatTime(DateUtil.getToday(), { dateStyle: "full", timeStyle: "medium", hourCycle: "h24" });
let n3 = DateUtil.getFormatTime(DateUtil.getToday(), { dateStyle: "full", timeStyle: "medium", hourCycle: "h12" });
let n4 = DateUtil.getFormatTime(DateUtil.getToday(), { weekday: "short" });

getFormatRange 格式化時間日期段字符串（DateTimeFormat）

let fr = DateUtil.getFormatRange(DateUtil.getAfterDay("2024-05-01"),DateUtil.getToday());

getFormatRelativeTime 格式化相對時間

let frt1 = DateUtil.getFormatRelativeTime(2, 'year');
let frt2 = DateUtil.getFormatRelativeTime(-1, 'year');
let frt3 = DateUtil.getFormatRelativeTime(-1, 'quarter');
let frt4 = DateUtil.getFormatRelativeTime(-2, 'month');
let frt5 = DateUtil.getFormatRelativeTime(-3, 'week');
let frt6 = DateUtil.getFormatRelativeTime(-6, 'day');
let frt7 = DateUtil.getFormatRelativeTime(-6, 'hour');
let frt8 = DateUtil.getFormatRelativeTime(-7, 'minute');
let frt9 = DateUtil.getFormatRelativeTime(-8, 'second');

getTipDateStr 格式化時間戳，獲取提示性時間字符串

let timeStamp = DateUtil.getTodayTime();
let tip1 = DateUtil.getTipDateStr(timeStamp);
let tip2 = DateUtil.getTipDateStr(timeStamp - 60000 * 5);
let tip3 = DateUtil.getTipDateStr(timeStamp - 3600000 * 3);
let tip4 = DateUtil.getTipDateStr(timeStamp - 3600000 * 24 * 2);
let tip5 = DateUtil.getTipDateStr(timeStamp - 3600000 * 24 * 360 * 1);

創作不易，請給童長老點贊

審核編輯 黃宇