公共组件详细设计说明书.doc

详细设计说明书 基本公用函数 中国邮政储蓄银行 日期时间类 取系统当前时间　long GetTime() 功能说明 取系统当前时间 输入参数 无 输出参数 无 返回值 hhmmss格式的时间 说明 本函数取的是当前应用服务器上的机器时间（不同的应用服务器上时间不可能完全同步）。 取系统当前日期　void rtoday (char *today) 功能 取操作系统当前日期 输入参数 无 输出参数 9位字符串, 操作系统当前日期（格式为YYYYMMDD） 返回值 无 说明 本函数取的是当前应用服务器上的机器日期（不同的应用服务器上日期不可能完全同步）。 日期转化为年月日int Date2MDY(char *date,int *month,int *day,int *year) 功能 根据字符串日期获取年月日 输入参数 字符串日期*date (格式为YYYYMMDD) 输出参数 月份*month 日期*day 年份*year 返回值 0表示成功；其他值表示失败。当date在 (01/01/1900)和(12/31/9999)之间时成功。 说明 不需要的参数可以填NULL，不用定义另外的变量。如：只关心日期时可以这样调用：Date2MDY(date,NULL,&day,NULL); 是否闰年　int IsLeapYear(int year) 功能 判断指定年份是否闰年 输入参数 整型年份year 输出参数 无 返回值 TRUE表示是闰年；FALSE表示不是。 日期转换为天数int Date2Day(char date1[9], int * retday) 功能: 字符串日期转换为天数 输入参数 字符串日期 char[9]; 输出参数 整型日期天数: retday 返回值 -1,转换错误; 0转换成功 说明 天数(从1899.12.31开始) 根据日期计算星期几int rdayofweek(char *date ) 功能 根据字符串型日期返回 礼拜几 输入参数 字符串日期型 输出参数 无 返回值 正整数(0~6) 周日~周六 -1 失败 根据增加天数计算日期int DateChange(char *in_date,int days,char *out_date) 功能 字符串型日期添加天数 输入参数 字符串日期型 int型天数 输出参数 字符串日期型 返回参数 0 成功; -1 失败; 日期格式化转换int Date2fmt(char *date,char *fmt,char *out_str) 功能 字符串型日期格式化输出 输入参数 date 字符串日期型 fmt 字符串型格式字符串 支持 %Y %M %D 输出参数 out_date 格式化后的字符串 返回值 0 成功 -1 失败 取系统时间戳void GetTimeStamp(char *stamp) 功能 取系统时间戳，格式为YYYYMMDDHHMMSSMMM，共17位。 输入参数 无 输出参数 17位的时间戳，格式为YYYYMMDDHHMMSSMMM 返回值 无 取系统时间戳int dtcurrent(long *dt) 功能 取系统时间戳(从1970/1/1/00.00.00 开始的秒数) 输入参数 无 输出参数 long型的描述 返回值 0 成功 -1 失败 取时间戳格式化输出int DT2fmt(long dt,char *fmt,char *out_str) 功能 long型时间戳格式化输出 输入参数 long 型 时间戳 字符串格式 支持 %Y %M %D %h %m %s 输出参数 格式化后的字符串 返回参数 0 成功 -1 失败 字符串时间转换成long时间戳int asc2DT(char *str,long *dt) 功能 14位字符串时间转换成long时间戳 输入参数 字符串日期型 14位输入 YYYYMMDDHHMMSS 输出参数 long 型的时间戳 返回参数 0 成功 -1 失败 时间戳转换成字符串时间int DT2asc(long dt,char *str) 功能 时间戳转换成字符串时间 输入参数 long型的时间戳 输出参数 字符串 14位 YYYYMMDDHHMMSS 返回函数 0 成功 -1 失败 月,日,年转换成字符串型时间int MDY2Date(int m,int d,int y,char *out_date) 功能 int型月,日,年转换成字符串型时间 输入