建设部网站投诉核查企业名单,闵行交大网站建设,天津大邱庄网站建设公司,wordpress 简体中文PostgreSQL格式化函数提供一套强大的工具用于把各种数据类型 #xff08;日期/时间、整数、浮点、数字#xff09; 转换成格式化的字符串以及反过来从格式化的字符串转换成 指定的数据类型。下表列出了这些函数。这些函数都遵循一个公共的调用规范#xff1a; 第一个参数是待…PostgreSQL格式化函数提供一套强大的工具用于把各种数据类型 日期/时间、整数、浮点、数字 转换成格式化的字符串以及反过来从格式化的字符串转换成 指定的数据类型。下表列出了这些函数。这些函数都遵循一个公共的调用规范 第一个参数是待格式化的值而第二个是一个定义输出或输入格式的模板。
函数返回类型描述例子to_char(timestamp, text)text把时间戳转成字符串to_char(current_timestamp, HH12:MI:SS)to_char(interval, text)text把间隔转成字符串to_char(interval 15h 2m 12s, HH24:MI:SS)to_char(int, text)text把整数转成字符串to_char(125, 999)to_char(double precision, text)text把实数或双精度转成字符串to_char(125.8::real, 999D9)to_char(numeric, text)text把数字转成字符串to_char(-125.8, 999D99S)to_date(text, text)date把字符串转成日期to_date(05 Dec 2000, DD Mon YYYY)to_number(text, text)numeric把字符串转成数字to_number(12,454.8-, 99G999D9S)to_timestamp(text, text)timestamp with time zone把字符串转成时间戳to_timestamp(05 Dec 2000, DD Mon YYYY) to_timestamp和to_date存在的目的是为了处理无法用简单造型转换的输入格式。对于大部分标准的日期/时间格式简单地把源字符串造型成所需的数据类型是可以的并且简单很多。类似地对于标准的数字表示形式to_number也是没有必要的。
在一个to_char输出模板串中一些特定的模式可以被识别并且被替换成基于给定值的被恰当地格式化的数据。任何不属于模板模式的文本都简单地照字面拷贝。同样在一个输入 模板串里对其他函数模板模式标识由输入数据串提供的值。如果在模板字符串中有不是模板模式的字符输入数据字符串中的对应字符会被简单地跳过不管它们是否等于模板字符串字符。
用于日期/时间格式化的模板模式 模式描述HH一天中的小时 01-12HH12一天中的小时 01-12HH24一天中的小时 00-23MI分钟 00-59minute (00-59)SS秒00-59MS毫秒000-999US微秒000000-999999SSSS午夜后的秒0-86399AM, am, PM or pm正午指示器不带句号A.M., a.m., P.M. or p.m.正午指示器带句号Y,YYY带逗号的年4 位或者更多位YYYY年4 位或者更多位YYY年的后三位YY年的后两位Y年的最后一位IYYYISO 8601 周编号方式的年4 位或更多位IYYISO 8601 周编号方式的年的最后 3 位IYISO 8601 周编号方式的年的最后 2 位IISO 8601 周编号方式的年的最后一位BC, bc, AD或者ad纪元指示器不带句号B.C., b.c., A.D.或者a.d.纪元指示器带句号MONTH全大写形式的月名空格补齐到 9 字符Month全首字母大写形式的月名空格补齐到 9 字符month全小写形式的月名空格补齐到 9 字符MON简写的大写形式的月名英文 3 字符本地化长度可变Mon简写的首字母大写形式的月名英文 3 字符本地化长度可变mon简写的小写形式的月名英文 3 字符本地化长度可变MM月编号01-12DAY全大写形式的日名空格补齐到 9 字符Day全首字母大写形式的日名空格补齐到 9 字符day全小写形式的日名空格补齐到 9 字符DY简写的大写形式的日名英语 3 字符本地化长度可变Dy简写的首字母大写形式的日名英语 3 字符本地化长度可变dy简写的小写形式的日名英语 3 字符本地化长度可变DDD一年中的日001-366IDDDISO 8601 周编号方式的年中的日001-371年的第 1 日时第一个 ISO 周的周一DD月中的日01-31D周中的日周日1到周六7ID周中的 ISO 8601 日周一1到周日7W月中的周1-5第一周从该月的第一天开始WW年中的周数1-53第一周从该年的第一天开始IWISO 8601 周编号方式的年中的周数01 - 53新的一年的第一个周四在第一周CC世纪2 位数21 世纪开始于 2001-01-01J儒略日从午夜 UTC 的公元前 4714 年 11 月 24 日开始的整数日数Q季度to_date和to_timestamp会忽略RM大写形式的罗马计数法的月I-XIII 是 一月rm小写形式的罗马计数法的月i-xiii 是 一月TZ大写形式的时区缩写仅在to_char中支持tz小写形式的时区缩写仅在to_char中支持TZH时区的小时TZM时区的分钟OF从UTC开始的时区偏移仅在to_char中支持 修饰语可以被应用于模板模式来修改它们的行为。例如FMMonth就是带着FM修饰语的Month模式。下展示了可用于日期/时间格式化的修饰语模式。
修饰语描述例子FM prefix填充模式抑制前导零和填充的空格FMMonthTH suffix大写形式的序数后缀DDTH, e.g., 12THth suffix小写形式的序数后缀DDth, e.g., 12thFX prefix固定的格式化全局选项见使用须知FX Month DD DayTM prefix翻译模式基于lc_time打印本地化的日和月名TMMonthSP suffix拼写模式未实现DDSP 日期/时间格式化的使用须知 FM抑制前导的零或尾随的空白 否则会把它们增加到输入从而把一个模式的输出变成固定宽度。在PostgreSQL中FM只修改下一个声明而在 Oracle 中FM影响所有随后的声明并且重复的FM修饰语将触发填充模式开和关。 TM不包括结尾空白。to_timestamp和to_date会忽略TM修饰语。 to_timestamp和to_date跳过了输入字符串开头和日期和时间值周围的多个空格除非使用了FX选项。 例如to_to_timestamp( 2000 JUN, YYY-MON)和to_timestamp(2000 - JUN, YYY-MON)都能工作但to_timestamp(2000 JUN, FXYYYY-MON)返回一个错误因为to_timestamp只期望一个空格。FX必须指定为模板中的第一个项目。 to_timestamp和to_date的模板字符串中的分隔符一个空格或非字母/非数字字符与输入字符串中的任何一个分隔符相匹配或者被跳过除非使用了FX选项。例如to_to_timestamp(2000JUN, YYY///MON)和to_timestamp(2000/JUN, YYY/MON)可以工作但to_timestamp(2000/JUN, YYYY/MON)返回一个错误因为输入字符串中的分隔符数量超过了模板中的分隔符数量。 如果指定了FX模板字符串中的分隔符正好与输入字符串中的一个字符匹配。 但要注意的是输入字符串中的字符不需要与模板字符串中的分隔符相同。例如to_timestamp(2000/JUN, FXYYYY MON)可以工作但是to_timestamp(2000/JUN, FXYYYY MON)返回错误因为模板字符串中的第二个空格会消耗掉输入字符串中的字母J。 TZH模板模式可以匹配一个有符号的数字。如果没有FX选项减号可能是模糊的可能被解释为分隔符。这种模棱两可的问题可以通过以下方式解决。 如果模板字符串中TZH前的分隔符的数量小于输入字符串中减号前的分隔符数量则减号被解释为TZH的一部分。否则减号被认为是值之间的分隔符。例如to_timestamp(2000 -10, YYY TZH)与-10匹配但to_timestamp(2000 -10, YYYY TZH)匹配10到TZH。 在to_char模板里可以有普通文本并且它们会被照字面输出。你可以把一个子串放到双引号里强迫它被解释成一个文本即使它里面包含模板模式也如此。例如在 Hello Year YYYY中YYYY将被年份数据代替但是Year中单独的Y不会。在to_date、to_number以及to_timestamp中文本和双引号字符串会导致跳过该字符串中所包含的字符数量例如XX会跳过两个输入字符不管它们是不是XX。 提示在PostgreSQL 12之前可以使用非字母或非数字字符跳过输入字符串中的任意文本。例如to_timestamp(2000y6m1d, yyyyy-MM-DD)以前是有效的。 现在你只能使用字母字符来实现这个目的。 例如to_timestamp(2000y6m1d, yyyytMMtDDt)和to_timestamp(2000y6m1d, yyyyyyMMmDDd)跳过y、m和d。 如果你想在输出里有双引号那么你必须在它们前面放反斜线例如 \YYYY Month\。不然在双引号字符串外面的反斜线就不是特殊的。在双引号字符串内反斜线会导致下一个字符被取其字面形式不管它是什么字符但是这没有特殊效果除非下一个字符是一个双引号或者另一个反斜线。 在to_timestamp和to_date中如果年份格式声明少于四位如YYY并且提供的年份少于四位年份将被调整为最接近于 2020 年例如95会变成 1995。 在to_timestamp和to_date中在处理超过4位数的年份时YYYY转换具有限制。你必须在YYYY后面使用一些非数字字符或者模板 否则年份总是被解释为 4 位数字。例如对于 20000 年to_date(200001131, YYYYMMDD)将会被解释成一个 4 位数字的年份而不是在年份后使用一个非数字分隔符像to_date(20000-1131, YYYY-MMDD)或to_date(20000Nov31, YYYYMonDD)。 在to_timestamp和to_date中CC世纪字段会被接受但是如果有YYY、YYYY或者Y,YYY字段则会忽略它。如果CC与YY或Y一起使用则结果被计算为指定世纪中的那一年。如果指定了世纪但是没有指定年则会假定为该世纪的第一年。 在to_timestamp和to_date中工作日名称或编号DAY、D以及相关的字段类型会被接受但会为了计算结果的目的而忽略。季度Q字段也是一样。 在to_timestamp和to_date中一个 ISO 8601 周编号的日期与一个格里高利日期相区别可以用两种方法之一被指定为to_timestamp和to_date 年、周编号和工作日例如to_date(2006-42-4, IYYY-IW-ID)返回日期2006-10-19。如果你忽略工作日它被假定为 1周一。 年和一年中的日例如to_date(2006-291, IYYY-IDDD)也返回2006-10-19。 尝试使用一个混合了 ISO 8601 周编号和格里高利日期的域来输入一个日期是无意义的并且将导致一个错误。在一个 ISO 周编号的年的环境下一个“月”或“月中的日”的概念没有意义。在一个格里高利年的环境下ISO 周没有意义。用户应当避免混合格里高利和 ISO 日期声明。 小心虽然to_date将会拒绝混合使用格里高利和 ISO 周编号日期的域 to_char却不会因为YYYY-MM-DD (IYYY-IDDD) 这种输出格式也会有用。但是避免写类似IYYY-MM-DD的东西那会得到在 起始年附近令人惊讶的结果 在to_timestamp中毫秒MS和微秒US域都被用作小数点后的秒位。例如to_timestamp(12.3, SS.MS)不是 3 毫秒, 而是 300因为该转换把它看做 12 0.3 秒。这意味着对于格式SS.MS而言输入值12.3、12.30和12.300指定了相同数目的毫秒。要得到三毫秒你必须使用 12.003转换会把它看做 12 0.003 12.003 秒。 下面是一个更复杂的例子∶to_timestamp(15:12:02.020.001230, HH24:MI:SS.MS.US)是 15 小时、12 分钟和 2 秒 20 毫秒 1230微秒 2.021230 秒。 to_char(..., ID)的一周中日的编号匹配extract(isodow from ...)函数但是to_char(..., D)不匹配extract(dow from ...)的日编号。 to_char(interval)格式化HH和HH12为显示在一个 12 小时的时钟上即零小时和 36 小时输出为12而HH24会输出完整的小时值对于间隔它可以超过 23.
用于数字格式化的模板模式
模式描述9数位如果无意义可以被删除0数位即便没有意义也不会被删除. (period)小数点, (comma)分组千分隔符PR尖括号内的负值S带符号的数字使用区域L货币符号使用区域D小数点使用区域G分组分隔符使用区域MI在指定位置的负号如果数字 0PL在指定位置的正号如果数字 0SG在指定位置的正/负号RN罗马数字输入在 1 和 3999 之间TH or th序数后缀V移动指定位数参阅注解EEEE科学记数的指数 数字格式化的用法须知 0指定一个总是被打印的数位即便它包含前导/拖尾的零。9也指定一个数位但是如果它是前导零则会被空格替换而如果是拖尾零并且指定了填充模式则它会被删除对于to_number()来说这两种模式字符等效。 模式字符S、L、D以及G表示当前locale定义的负号、货币符号、小数点以及数字分隔符字符见lc_monetary和lc_numeric。不管locale是什么模式字符句号和逗号就表示小数点和数字分隔符。 对于to_char()的模式中的一个负号如果没有明确的规定将为该负号保留一列并且它将被锚接到出现在左边那个数字。如果S正好出现在某个9的左边它也将被锚接到那个数字。 使用SG、PL或MI格式化的符号并不挂在数字上面 例如to_char(-12, MI9999)生成- 12而to_char(-12, S9999)生成 -12。Oracle 里的实现不允许在9前面使用MI而是要求9在MI前面。 TH不会转换小于零的数值也不会转换小数。 PL、SG和TH是PostgreSQL扩展。 在to_number中如果没有使用L或TH之类的非数据模板模式相应数量的输入字符会被跳过不管它们是否匹配模板模式除非它们是数据字符也就是数位、负号、小数点或者逗号。例如TH会跳过两个非数据字符。 带有to_char的V会把输入值乘上10^n其中n是跟在V后面的位数。带有to_number的V以类似的方式做除法。to_char和to_number不支持使用结合小数点的V例如不允许99.9V99。 EEEE科学记数法不能和任何其他格式化模式或修饰语数字和小数点模式除外组合在一起使用并且必须位于格式化字符串的最后例如9.99EEEE是一个合法的模式。 某些修饰语可以被应用到任何模板来改变其行为。例如FM99.99是带有FM修饰语的99.99模式。下表中展示了用于数字格式化模式修饰语。
修饰语描述例子FM prefix填充模式抑制拖尾零和填充的空白FM99.99TH suffix大写序数后缀999THth suffix小写序数后缀999th
to_char例子
表达式结果to_char(current_timestamp, Day, DD HH12:MI:SS)Tuesday , 06 05:39:18to_char(current_timestamp, FMDay, FMDD HH12:MI:SS)Tuesday, 6 05:39:18to_char(-0.1, 99.99) -.10to_char(-0.1, FM9.99)-.1to_char(-0.1, FM90.99)-0.1to_char(0.1, 0.9) 0.1to_char(12, 9990999.9) 0012.0to_char(12, FM9990999.9)0012.to_char(485, 999) 485to_char(-485, 999)-485to_char(485, 9 9 9) 4 8 5to_char(1485, 9,999) 1,485to_char(1485, 9G999) 1 485to_char(148.5, 999.999) 148.500to_char(148.5, FM999.999)148.5to_char(148.5, FM999.990)148.500to_char(148.5, 999D999) 148,500to_char(3148.5, 9G999D999) 3 148,500to_char(-485, 999S)485-to_char(-485, 999MI)485-to_char(485, 999MI)485 to_char(485, FM999MI)485to_char(485, PL999)485to_char(485, SG999)485to_char(-485, SG999)-485to_char(-485, 9SG99)4-85to_char(-485, 999PR)485to_char(485, L999)DM 485to_char(485, RN) CDLXXXVto_char(485, FMRN)CDLXXXVto_char(5.2, FMRN)Vto_char(482, 999th) 482ndto_char(485, Good number:999)Good number: 485to_char(485.8, Pre:999 Post: .999)Pre: 485 Post: .800to_char(12, 99V999) 12000to_char(12.4, 99V999) 12400to_char(12.45, 99V9) 125to_char(0.0004859, 9.99EEEE) 4.86e-04
