I686LINUX/util/I686LINUX/doc/postgresql/html/functions-formatting.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <HTML
   3 ><HEAD
   4 ><TITLE
   5 >Data Type Formatting Functions</TITLE
   6 ><META
   7 NAME="GENERATOR"
   8 CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
   9 REV="MADE"
  10 HREF="mailto:pgsql-docs@postgresql.org"><LINK
  11 REL="HOME"
  12 TITLE="PostgreSQL 7.4.1 Documentation"
  13 HREF="index.html"><LINK
  14 REL="UP"
  15 TITLE="Functions and Operators"
  16 HREF="functions.html"><LINK
  17 REL="PREVIOUS"
  18 TITLE="Pattern Matching"
  19 HREF="functions-matching.html"><LINK
  20 REL="NEXT"
  21 TITLE="Date/Time Functions and Operators"
  22 HREF="functions-datetime.html"><LINK
  23 REL="STYLESHEET"
  24 TYPE="text/css"
  25 HREF="stylesheet.css"><META
  26 NAME="creation"
  27 CONTENT="2003-12-22T03:48:47"></HEAD
  28 ><BODY
  29 CLASS="SECT1"
  30 ><DIV
  31 CLASS="NAVHEADER"
  32 ><TABLE
  33 SUMMARY="Header navigation table"
  34 WIDTH="100%"
  35 BORDER="0"
  36 CELLPADDING="0"
  37 CELLSPACING="0"
  38 ><TR
  39 ><TH
  40 COLSPAN="5"
  41 ALIGN="center"
  42 VALIGN="bottom"
  43 >PostgreSQL 7.4.1 Documentation</TH
  44 ></TR
  45 ><TR
  46 ><TD
  47 WIDTH="10%"
  48 ALIGN="left"
  49 VALIGN="top"
  50 ><A
  51 HREF="functions-matching.html"
  52 ACCESSKEY="P"
  53 >Prev</A
  54 ></TD
  55 ><TD
  56 WIDTH="10%"
  57 ALIGN="left"
  58 VALIGN="top"
  59 ><A
  60 HREF="functions.html"
  61 >Fast Backward</A
  62 ></TD
  63 ><TD
  64 WIDTH="60%"
  65 ALIGN="center"
  66 VALIGN="bottom"
  67 >Chapter 9. Functions and Operators</TD
  68 ><TD
  69 WIDTH="10%"
  70 ALIGN="right"
  71 VALIGN="top"
  72 ><A
  73 HREF="functions.html"
  74 >Fast Forward</A
  75 ></TD
  76 ><TD
  77 WIDTH="10%"
  78 ALIGN="right"
  79 VALIGN="top"
  80 ><A
  81 HREF="functions-datetime.html"
  82 ACCESSKEY="N"
  83 >Next</A
  84 ></TD
  85 ></TR
  86 ></TABLE
  87 ><HR
  88 ALIGN="LEFT"
  89 WIDTH="100%"></DIV
  90 ><DIV
  91 CLASS="SECT1"
  92 ><H1
  93 CLASS="SECT1"
  94 ><A
  95 NAME="FUNCTIONS-FORMATTING"
  96 >9.7. Data Type Formatting Functions</A
  97 ></H1
  98 ><A
  99 NAME="AEN9012"
 100 ></A
 101 ><A
 102 NAME="AEN9014"
 103 ></A
 104 ><P
 105 >    The <SPAN
 106 CLASS="PRODUCTNAME"
 107 >PostgreSQL</SPAN
 108 > formatting functions
 109     provide a powerful set of tools for converting various data types
 110     (date/time, integer, floating point, numeric) to formatted strings
 111     and for converting from formatted strings to specific data types.
 112     <A
 113 HREF="functions-formatting.html#FUNCTIONS-FORMATTING-TABLE"
 114 >Table 9-20</A
 115 > lists them.
 116     These functions all follow a common calling convention: the first
 117     argument is the value to be formatted and the second argument is a
 118     template that defines the output or input format.
 119    </P
 120 ><DIV
 121 CLASS="TABLE"
 122 ><A
 123 NAME="FUNCTIONS-FORMATTING-TABLE"
 124 ></A
 125 ><P
 126 ><B
 127 >Table 9-20. Formatting Functions</B
 128 ></P
 129 ><TABLE
 130 BORDER="1"
 131 CLASS="CALSTABLE"
 132 ><COL><COL><COL><COL><THEAD
 133 ><TR
 134 ><TH
 135 >Function</TH
 136 ><TH
 137 >Return Type</TH
 138 ><TH
 139 >Description</TH
 140 ><TH
 141 >Example</TH
 142 ></TR
 143 ></THEAD
 144 ><TBODY
 145 ><TR
 146 ><TD
 147 ><TT
 148 CLASS="LITERAL"
 149 ><CODE
 150 CLASS="FUNCTION"
 151 >to_char</CODE
 152 >(<TT
 153 CLASS="TYPE"
 154 >timestamp</TT
 155 >, <TT
 156 CLASS="TYPE"
 157 >text</TT
 158 >)</TT
 159 ></TD
 160 ><TD
 161 ><TT
 162 CLASS="TYPE"
 163 >text</TT
 164 ></TD
 165 ><TD
 166 >convert time stamp to string</TD
 167 ><TD
 168 ><TT
 169 CLASS="LITERAL"
 170 >to_char(current_timestamp, 'HH12:MI:SS')</TT
 171 ></TD
 172 ></TR
 173 ><TR
 174 ><TD
 175 ><TT
 176 CLASS="LITERAL"
 177 ><CODE
 178 CLASS="FUNCTION"
 179 >to_char</CODE
 180 >(<TT
 181 CLASS="TYPE"
 182 >interval</TT
 183 >, <TT
 184 CLASS="TYPE"
 185 >text</TT
 186 >)</TT
 187 ></TD
 188 ><TD
 189 ><TT
 190 CLASS="TYPE"
 191 >text</TT
 192 ></TD
 193 ><TD
 194 >convert interval to string</TD
 195 ><TD
 196 ><TT
 197 CLASS="LITERAL"
 198 >to_char(interval '15h&nbsp;2m&nbsp;12s', 'HH24:MI:SS')</TT
 199 ></TD
 200 ></TR
 201 ><TR
 202 ><TD
 203 ><TT
 204 CLASS="LITERAL"
 205 ><CODE
 206 CLASS="FUNCTION"
 207 >to_char</CODE
 208 >(<TT
 209 CLASS="TYPE"
 210 >int</TT
 211 >, <TT
 212 CLASS="TYPE"
 213 >text</TT
 214 >)</TT
 215 ></TD
 216 ><TD
 217 ><TT
 218 CLASS="TYPE"
 219 >text</TT
 220 ></TD
 221 ><TD
 222 >convert integer to string</TD
 223 ><TD
 224 ><TT
 225 CLASS="LITERAL"
 226 >to_char(125, '999')</TT
 227 ></TD
 228 ></TR
 229 ><TR
 230 ><TD
 231 ><TT
 232 CLASS="LITERAL"
 233 ><CODE
 234 CLASS="FUNCTION"
 235 >to_char</CODE
 236 >(<TT
 237 CLASS="TYPE"
 238 >double precision</TT
 239 >,
 240         <TT
 241 CLASS="TYPE"
 242 >text</TT
 243 >)</TT
 244 ></TD
 245 ><TD
 246 ><TT
 247 CLASS="TYPE"
 248 >text</TT
 249 ></TD
 250 ><TD
 251 >convert real/double precision to string</TD
 252 ><TD
 253 ><TT
 254 CLASS="LITERAL"
 255 >to_char(125.8::real, '999D9')</TT
 256 ></TD
 257 ></TR
 258 ><TR
 259 ><TD
 260 ><TT
 261 CLASS="LITERAL"
 262 ><CODE
 263 CLASS="FUNCTION"
 264 >to_char</CODE
 265 >(<TT
 266 CLASS="TYPE"
 267 >numeric</TT
 268 >, <TT
 269 CLASS="TYPE"
 270 >text</TT
 271 >)</TT
 272 ></TD
 273 ><TD
 274 ><TT
 275 CLASS="TYPE"
 276 >text</TT
 277 ></TD
 278 ><TD
 279 >convert numeric to string</TD
 280 ><TD
 281 ><TT
 282 CLASS="LITERAL"
 283 >to_char(-125.8, '999D99S')</TT
 284 ></TD
 285 ></TR
 286 ><TR
 287 ><TD
 288 ><TT
 289 CLASS="LITERAL"
 290 ><CODE
 291 CLASS="FUNCTION"
 292 >to_date</CODE
 293 >(<TT
 294 CLASS="TYPE"
 295 >text</TT
 296 >, <TT
 297 CLASS="TYPE"
 298 >text</TT
 299 >)</TT
 300 ></TD
 301 ><TD
 302 ><TT
 303 CLASS="TYPE"
 304 >date</TT
 305 ></TD
 306 ><TD
 307 >convert string to date</TD
 308 ><TD
 309 ><TT
 310 CLASS="LITERAL"
 311 >to_date('05&nbsp;Dec&nbsp;2000', 'DD&nbsp;Mon&nbsp;YYYY')</TT
 312 ></TD
 313 ></TR
 314 ><TR
 315 ><TD
 316 ><TT
 317 CLASS="LITERAL"
 318 ><CODE
 319 CLASS="FUNCTION"
 320 >to_timestamp</CODE
 321 >(<TT
 322 CLASS="TYPE"
 323 >text</TT
 324 >, <TT
 325 CLASS="TYPE"
 326 >text</TT
 327 >)</TT
 328 ></TD
 329 ><TD
 330 ><TT
 331 CLASS="TYPE"
 332 >timestamp</TT
 333 ></TD
 334 ><TD
 335 >convert string to time stamp</TD
 336 ><TD
 337 ><TT
 338 CLASS="LITERAL"
 339 >to_timestamp('05&nbsp;Dec&nbsp;2000', 'DD&nbsp;Mon&nbsp;YYYY')</TT
 340 ></TD
 341 ></TR
 342 ><TR
 343 ><TD
 344 ><TT
 345 CLASS="LITERAL"
 346 ><CODE
 347 CLASS="FUNCTION"
 348 >to_number</CODE
 349 >(<TT
 350 CLASS="TYPE"
 351 >text</TT
 352 >, <TT
 353 CLASS="TYPE"
 354 >text</TT
 355 >)</TT
 356 ></TD
 357 ><TD
 358 ><TT
 359 CLASS="TYPE"
 360 >numeric</TT
 361 ></TD
 362 ><TD
 363 >convert string to numeric</TD
 364 ><TD
 365 ><TT
 366 CLASS="LITERAL"
 367 >to_number('12,454.8-', '99G999D9S')</TT
 368 ></TD
 369 ></TR
 370 ></TBODY
 371 ></TABLE
 372 ></DIV
 373 ><P
 374 >    Warning: <TT
 375 CLASS="LITERAL"
 376 ><CODE
 377 CLASS="FUNCTION"
 378 >to_char</CODE
 379 >(<TT
 380 CLASS="TYPE"
 381 >interval</TT
 382 >, <TT
 383 CLASS="TYPE"
 384 >text</TT
 385 >)</TT
 386 >
 387     is deprecated and should not be used in newly-written code. It will be removed in the next version.
 388    </P
 389 ><P
 390 >    In an output template string (for <CODE
 391 CLASS="FUNCTION"
 392 >to_char</CODE
 393 >), there are certain patterns that are
 394     recognized and replaced with appropriately-formatted data from the value
 395     to be formatted.  Any text that is not a template pattern is simply
 396     copied verbatim.  Similarly, in an input template string (for anything but <CODE
 397 CLASS="FUNCTION"
 398 >to_char</CODE
 399 >), template patterns
 400     identify the parts of the input data string to be looked at and the
 401     values to be found there.
 402    </P
 403 ><P
 404 >   <A
 405 HREF="functions-formatting.html#FUNCTIONS-FORMATTING-DATETIME-TABLE"
 406 >Table 9-21</A
 407 > shows the
 408    template patterns available for formatting date and time values.
 409   </P
 410 ><DIV
 411 CLASS="TABLE"
 412 ><A
 413 NAME="FUNCTIONS-FORMATTING-DATETIME-TABLE"
 414 ></A
 415 ><P
 416 ><B
 417 >Table 9-21. Template Patterns for Date/Time Formatting</B
 418 ></P
 419 ><TABLE
 420 BORDER="1"
 421 CLASS="CALSTABLE"
 422 ><COL><COL><THEAD
 423 ><TR
 424 ><TH
 425 >Pattern</TH
 426 ><TH
 427 >Description</TH
 428 ></TR
 429 ></THEAD
 430 ><TBODY
 431 ><TR
 432 ><TD
 433 ><TT
 434 CLASS="LITERAL"
 435 >HH</TT
 436 ></TD
 437 ><TD
 438 >hour of day (01-12)</TD
 439 ></TR
 440 ><TR
 441 ><TD
 442 ><TT
 443 CLASS="LITERAL"
 444 >HH12</TT
 445 ></TD
 446 ><TD
 447 >hour of day (01-12)</TD
 448 ></TR
 449 ><TR
 450 ><TD
 451 ><TT
 452 CLASS="LITERAL"
 453 >HH24</TT
 454 ></TD
 455 ><TD
 456 >hour of day (00-23)</TD
 457 ></TR
 458 ><TR
 459 ><TD
 460 ><TT
 461 CLASS="LITERAL"
 462 >MI</TT
 463 ></TD
 464 ><TD
 465 >minute (00-59)</TD
 466 ></TR
 467 ><TR
 468 ><TD
 469 ><TT
 470 CLASS="LITERAL"
 471 >SS</TT
 472 ></TD
 473 ><TD
 474 >second (00-59)</TD
 475 ></TR
 476 ><TR
 477 ><TD
 478 ><TT
 479 CLASS="LITERAL"
 480 >MS</TT
 481 ></TD
 482 ><TD
 483 >millisecond (000-999)</TD
 484 ></TR
 485 ><TR
 486 ><TD
 487 ><TT
 488 CLASS="LITERAL"
 489 >US</TT
 490 ></TD
 491 ><TD
 492 >microsecond (000000-999999)</TD
 493 ></TR
 494 ><TR
 495 ><TD
 496 ><TT
 497 CLASS="LITERAL"
 498 >SSSS</TT
 499 ></TD
 500 ><TD
 501 >seconds past midnight (0-86399)</TD
 502 ></TR
 503 ><TR
 504 ><TD
 505 ><TT
 506 CLASS="LITERAL"
 507 >AM</TT
 508 > or <TT
 509 CLASS="LITERAL"
 510 >A.M.</TT
 511 > or
 512         <TT
 513 CLASS="LITERAL"
 514 >PM</TT
 515 > or <TT
 516 CLASS="LITERAL"
 517 >P.M.</TT
 518 ></TD
 519 ><TD
 520 >meridian indicator (upper case)</TD
 521 ></TR
 522 ><TR
 523 ><TD
 524 ><TT
 525 CLASS="LITERAL"
 526 >am</TT
 527 > or <TT
 528 CLASS="LITERAL"
 529 >a.m.</TT
 530 > or
 531         <TT
 532 CLASS="LITERAL"
 533 >pm</TT
 534 > or <TT
 535 CLASS="LITERAL"
 536 >p.m.</TT
 537 ></TD
 538 ><TD
 539 >meridian indicator (lower case)</TD
 540 ></TR
 541 ><TR
 542 ><TD
 543 ><TT
 544 CLASS="LITERAL"
 545 >Y,YYY</TT
 546 ></TD
 547 ><TD
 548 >year (4 and more digits) with comma</TD
 549 ></TR
 550 ><TR
 551 ><TD
 552 ><TT
 553 CLASS="LITERAL"
 554 >YYYY</TT
 555 ></TD
 556 ><TD
 557 >year (4 and more digits)</TD
 558 ></TR
 559 ><TR
 560 ><TD
 561 ><TT
 562 CLASS="LITERAL"
 563 >YYY</TT
 564 ></TD
 565 ><TD
 566 >last 3 digits of year</TD
 567 ></TR
 568 ><TR
 569 ><TD
 570 ><TT
 571 CLASS="LITERAL"
 572 >YY</TT
 573 ></TD
 574 ><TD
 575 >last 2 digits of year</TD
 576 ></TR
 577 ><TR
 578 ><TD
 579 ><TT
 580 CLASS="LITERAL"
 581 >Y</TT
 582 ></TD
 583 ><TD
 584 >last digit of year</TD
 585 ></TR
 586 ><TR
 587 ><TD
 588 ><TT
 589 CLASS="LITERAL"
 590 >BC</TT
 591 > or <TT
 592 CLASS="LITERAL"
 593 >B.C.</TT
 594 > or
 595         <TT
 596 CLASS="LITERAL"
 597 >AD</TT
 598 > or <TT
 599 CLASS="LITERAL"
 600 >A.D.</TT
 601 ></TD
 602 ><TD
 603 >era indicator (upper case)</TD
 604 ></TR
 605 ><TR
 606 ><TD
 607 ><TT
 608 CLASS="LITERAL"
 609 >bc</TT
 610 > or <TT
 611 CLASS="LITERAL"
 612 >b.c.</TT
 613 > or
 614         <TT
 615 CLASS="LITERAL"
 616 >ad</TT
 617 > or <TT
 618 CLASS="LITERAL"
 619 >a.d.</TT
 620 ></TD
 621 ><TD
 622 >era indicator (lower case)</TD
 623 ></TR
 624 ><TR
 625 ><TD
 626 ><TT
 627 CLASS="LITERAL"
 628 >MONTH</TT
 629 ></TD
 630 ><TD
 631 >full upper-case month name (blank-padded to 9 chars)</TD
 632 ></TR
 633 ><TR
 634 ><TD
 635 ><TT
 636 CLASS="LITERAL"
 637 >Month</TT
 638 ></TD
 639 ><TD
 640 >full mixed-case month name (blank-padded to 9 chars)</TD
 641 ></TR
 642 ><TR
 643 ><TD
 644 ><TT
 645 CLASS="LITERAL"
 646 >month</TT
 647 ></TD
 648 ><TD
 649 >full lower-case month name (blank-padded to 9 chars)</TD
 650 ></TR
 651 ><TR
 652 ><TD
 653 ><TT
 654 CLASS="LITERAL"
 655 >MON</TT
 656 ></TD
 657 ><TD
 658 >abbreviated upper-case month name (3 chars)</TD
 659 ></TR
 660 ><TR
 661 ><TD
 662 ><TT
 663 CLASS="LITERAL"
 664 >Mon</TT
 665 ></TD
 666 ><TD
 667 >abbreviated mixed-case month name (3 chars)</TD
 668 ></TR
 669 ><TR
 670 ><TD
 671 ><TT
 672 CLASS="LITERAL"
 673 >mon</TT
 674 ></TD
 675 ><TD
 676 >abbreviated lower-case month name (3 chars)</TD
 677 ></TR
 678 ><TR
 679 ><TD
 680 ><TT
 681 CLASS="LITERAL"
 682 >MM</TT
 683 ></TD
 684 ><TD
 685 >month number (01-12)</TD
 686 ></TR
 687 ><TR
 688 ><TD
 689 ><TT
 690 CLASS="LITERAL"
 691 >DAY</TT
 692 ></TD
 693 ><TD
 694 >full upper-case day name (blank-padded to 9 chars)</TD
 695 ></TR
 696 ><TR
 697 ><TD
 698 ><TT
 699 CLASS="LITERAL"
 700 >Day</TT
 701 ></TD
 702 ><TD
 703 >full mixed-case day name (blank-padded to 9 chars)</TD
 704 ></TR
 705 ><TR
 706 ><TD
 707 ><TT
 708 CLASS="LITERAL"
 709 >day</TT
 710 ></TD
 711 ><TD
 712 >full lower-case day name (blank-padded to 9 chars)</TD
 713 ></TR
 714 ><TR
 715 ><TD
 716 ><TT
 717 CLASS="LITERAL"
 718 >DY</TT
 719 ></TD
 720 ><TD
 721 >abbreviated upper-case day name (3 chars)</TD
 722 ></TR
 723 ><TR
 724 ><TD
 725 ><TT
 726 CLASS="LITERAL"
 727 >Dy</TT
 728 ></TD
 729 ><TD
 730 >abbreviated mixed-case day name (3 chars)</TD
 731 ></TR
 732 ><TR
 733 ><TD
 734 ><TT
 735 CLASS="LITERAL"
 736 >dy</TT
 737 ></TD
 738 ><TD
 739 >abbreviated lower-case day name (3 chars)</TD
 740 ></TR
 741 ><TR
 742 ><TD
 743 ><TT
 744 CLASS="LITERAL"
 745 >DDD</TT
 746 ></TD
 747 ><TD
 748 >day of year (001-366)</TD
 749 ></TR
 750 ><TR
 751 ><TD
 752 ><TT
 753 CLASS="LITERAL"
 754 >DD</TT
 755 ></TD
 756 ><TD
 757 >day of month (01-31)</TD
 758 ></TR
 759 ><TR
 760 ><TD
 761 ><TT
 762 CLASS="LITERAL"
 763 >D</TT
 764 ></TD
 765 ><TD
 766 >day of week (1-7; Sunday is 1)</TD
 767 ></TR
 768 ><TR
 769 ><TD
 770 ><TT
 771 CLASS="LITERAL"
 772 >W</TT
 773 ></TD
 774 ><TD
 775 >week of month (1-5) (The first week starts on the first day of the month.)</TD
 776 ></TR
 777 ><TR
 778 ><TD
 779 ><TT
 780 CLASS="LITERAL"
 781 >WW</TT
 782 ></TD
 783 ><TD
 784 >week number of year (1-53) (The first week starts on the first day of the year.)</TD
 785 ></TR
 786 ><TR
 787 ><TD
 788 ><TT
 789 CLASS="LITERAL"
 790 >IW</TT
 791 ></TD
 792 ><TD
 793 >ISO week number of year (The first Thursday of the new year is in week 1.)</TD
 794 ></TR
 795 ><TR
 796 ><TD
 797 ><TT
 798 CLASS="LITERAL"
 799 >CC</TT
 800 ></TD
 801 ><TD
 802 >century (2 digits)</TD
 803 ></TR
 804 ><TR
 805 ><TD
 806 ><TT
 807 CLASS="LITERAL"
 808 >J</TT
 809 ></TD
 810 ><TD
 811 >Julian Day (days since January 1, 4712 BC)</TD
 812 ></TR
 813 ><TR
 814 ><TD
 815 ><TT
 816 CLASS="LITERAL"
 817 >Q</TT
 818 ></TD
 819 ><TD
 820 >quarter</TD
 821 ></TR
 822 ><TR
 823 ><TD
 824 ><TT
 825 CLASS="LITERAL"
 826 >RM</TT
 827 ></TD
 828 ><TD
 829 >month in Roman numerals (I-XII; I=January) (upper case)</TD
 830 ></TR
 831 ><TR
 832 ><TD
 833 ><TT
 834 CLASS="LITERAL"
 835 >rm</TT
 836 ></TD
 837 ><TD
 838 >month in Roman numerals (i-xii; i=January) (lower case)</TD
 839 ></TR
 840 ><TR
 841 ><TD
 842 ><TT
 843 CLASS="LITERAL"
 844 >TZ</TT
 845 ></TD
 846 ><TD
 847 >time-zone name (upper case)</TD
 848 ></TR
 849 ><TR
 850 ><TD
 851 ><TT
 852 CLASS="LITERAL"
 853 >tz</TT
 854 ></TD
 855 ><TD
 856 >time-zone name (lower case)</TD
 857 ></TR
 858 ></TBODY
 859 ></TABLE
 860 ></DIV
 861 ><P
 862 >    Certain modifiers may be applied to any template pattern to alter its
 863     behavior.  For example, <TT
 864 CLASS="LITERAL"
 865 >FMMonth</TT
 866 >
 867     is the <TT
 868 CLASS="LITERAL"
 869 >Month</TT
 870 > pattern with the
 871     <TT
 872 CLASS="LITERAL"
 873 >FM</TT
 874 > modifier.
 875     <A
 876 HREF="functions-formatting.html#FUNCTIONS-FORMATTING-DATETIMEMOD-TABLE"
 877 >Table 9-22</A
 878 > shows the
 879     modifier patterns for date/time formatting.
 880    </P
 881 ><DIV
 882 CLASS="TABLE"
 883 ><A
 884 NAME="FUNCTIONS-FORMATTING-DATETIMEMOD-TABLE"
 885 ></A
 886 ><P
 887 ><B
 888 >Table 9-22. Template Pattern Modifiers for Date/Time Formatting</B
 889 ></P
 890 ><TABLE
 891 BORDER="1"
 892 CLASS="CALSTABLE"
 893 ><COL><COL><COL><THEAD
 894 ><TR
 895 ><TH
 896 >Modifier</TH
 897 ><TH
 898 >Description</TH
 899 ><TH
 900 >Example</TH
 901 ></TR
 902 ></THEAD
 903 ><TBODY
 904 ><TR
 905 ><TD
 906 ><TT
 907 CLASS="LITERAL"
 908 >FM</TT
 909 > prefix</TD
 910 ><TD
 911 >fill mode (suppress padding blanks and zeroes)</TD
 912 ><TD
 913 ><TT
 914 CLASS="LITERAL"
 915 >FMMonth</TT
 916 ></TD
 917 ></TR
 918 ><TR
 919 ><TD
 920 ><TT
 921 CLASS="LITERAL"
 922 >TH</TT
 923 > suffix</TD
 924 ><TD
 925 >upper-case ordinal number suffix</TD
 926 ><TD
 927 ><TT
 928 CLASS="LITERAL"
 929 >DDTH</TT
 930 ></TD
 931 ></TR
 932 ><TR
 933 ><TD
 934 ><TT
 935 CLASS="LITERAL"
 936 >th</TT
 937 > suffix</TD
 938 ><TD
 939 >lower-case ordinal number suffix</TD
 940 ><TD
 941 ><TT
 942 CLASS="LITERAL"
 943 >DDth</TT
 944 ></TD
 945 ></TR
 946 ><TR
 947 ><TD
 948 ><TT
 949 CLASS="LITERAL"
 950 >FX</TT
 951 > prefix</TD
 952 ><TD
 953 >fixed format global option (see usage notes)</TD
 954 ><TD
 955 ><TT
 956 CLASS="LITERAL"
 957 >FX&nbsp;Month&nbsp;DD&nbsp;Day</TT
 958 ></TD
 959 ></TR
 960 ><TR
 961 ><TD
 962 ><TT
 963 CLASS="LITERAL"
 964 >SP</TT
 965 > suffix</TD
 966 ><TD
 967 >spell mode (not yet implemented)</TD
 968 ><TD
 969 ><TT
 970 CLASS="LITERAL"
 971 >DDSP</TT
 972 ></TD
 973 ></TR
 974 ></TBODY
 975 ></TABLE
 976 ></DIV
 977 ><P
 978 >    Usage notes for the date/time formatting:
 979
 980     <P
 981 ></P
 982 ></P><UL
 983 ><LI
 984 ><P
 985 >       <TT
 986 CLASS="LITERAL"
 987 >FM</TT
 988 > suppresses leading zeroes and trailing blanks
 989        that would otherwise be added to make the output of a pattern be
 990        fixed-width.
 991       </P
 992 ></LI
 993 ><LI
 994 ><P
 995 >       <CODE
 996 CLASS="FUNCTION"
 997 >to_timestamp</CODE
 998 > and <CODE
 999 CLASS="FUNCTION"
1000 >to_date</CODE
1001 >
1002        skip multiple blank spaces in the input string if the <TT
1003 CLASS="LITERAL"
1004 >FX</TT
1005 > option
1006        is not used. <TT
1007 CLASS="LITERAL"
1008 >FX</TT
1009 > must be specified as the first item
1010        in the template.  For example
1011        <TT
1012 CLASS="LITERAL"
1013 >to_timestamp('2000&nbsp;&nbsp;&nbsp;&nbsp;JUN', 'YYYY MON')</TT
1014 > is correct, but
1015        <TT
1016 CLASS="LITERAL"
1017 >to_timestamp('2000&nbsp;&nbsp;&nbsp;&nbsp;JUN', 'FXYYYY MON')</TT
1018 > returns an error,
1019        because <CODE
1020 CLASS="FUNCTION"
1021 >to_timestamp</CODE
1022 > expects one space only.
1023       </P
1024 ></LI
1025 ><LI
1026 ><P
1027 >       Ordinary text is allowed in <CODE
1028 CLASS="FUNCTION"
1029 >to_char</CODE
1030 >
1031        templates and will be output literally.  You can put a substring
1032        in double quotes to force it to be interpreted as literal text
1033        even if it contains pattern key words.  For example, in
1034        <TT
1035 CLASS="LITERAL"
1036 >'"Hello Year "YYYY'</TT
1037 >, the <TT
1038 CLASS="LITERAL"
1039 >YYYY</TT
1040 >
1041        will be replaced by the year data, but the single <TT
1042 CLASS="LITERAL"
1043 >Y</TT
1044 > in <TT
1045 CLASS="LITERAL"
1046 >Year</TT
1047 >
1048        will not be.
1049       </P
1050 ></LI
1051 ><LI
1052 ><P
1053 >       If you want to have a double quote in the output you must
1054        precede it with a backslash, for example <TT
1055 CLASS="LITERAL"
1056 >'\\"YYYY
1057        Month\\"'</TT
1058 >.
1059        (Two backslashes are necessary because the backslash already
1060        has a special meaning in a string constant.)
1061       </P
1062 ></LI
1063 ><LI
1064 ><P
1065 >       The <TT
1066 CLASS="LITERAL"
1067 >YYYY</TT
1068 > conversion from string to <TT
1069 CLASS="TYPE"
1070 >timestamp</TT
1071 > or
1072        <TT
1073 CLASS="TYPE"
1074 >date</TT
1075 > has a restriction if you use a year with more than 4 digits. You must
1076        use some non-digit character or template after <TT
1077 CLASS="LITERAL"
1078 >YYYY</TT
1079 >,
1080        otherwise the year is always interpreted as 4 digits. For example
1081        (with the year 20000):
1082        <TT
1083 CLASS="LITERAL"
1084 >to_date('200001131', 'YYYYMMDD')</TT
1085 > will be
1086        interpreted as a 4-digit year; instead use a non-digit
1087        separator after the year, like
1088        <TT
1089 CLASS="LITERAL"
1090 >to_date('20000-1131', 'YYYY-MMDD')</TT
1091 > or
1092        <TT
1093 CLASS="LITERAL"
1094 >to_date('20000Nov31', 'YYYYMonDD')</TT
1095 >.
1096       </P
1097 ></LI
1098 ><LI
1099 ><P
1100 >       Millisecond (<TT
1101 CLASS="LITERAL"
1102 >MS</TT
1103 >) and microsecond (<TT
1104 CLASS="LITERAL"
1105 >US</TT
1106 >)
1107        values in a conversion from string to <TT
1108 CLASS="TYPE"
1109 >timestamp</TT
1110 > are used as part of the
1111        seconds after the decimal point. For example
1112        <TT
1113 CLASS="LITERAL"
1114 >to_timestamp('12:3', 'SS:MS')</TT
1115 > is not 3 milliseconds,
1116        but 300, because the conversion counts it as 12 + 0.3 seconds.
1117        This means for the format <TT
1118 CLASS="LITERAL"
1119 >SS:MS</TT
1120 >, the input values
1121        <TT
1122 CLASS="LITERAL"
1123 >12:3</TT
1124 >, <TT
1125 CLASS="LITERAL"
1126 >12:30</TT
1127 >, and <TT
1128 CLASS="LITERAL"
1129 >12:300</TT
1130 > specify the
1131        same number of milliseconds. To get three milliseconds, one must use
1132        <TT
1133 CLASS="LITERAL"
1134 >12:003</TT
1135 >, which the conversion counts as
1136        12 + 0.003 = 12.003 seconds.
1137       </P
1138 ><P
1139 >       Here is a more
1140        complex example:
1141        <TT
1142 CLASS="LITERAL"
1143 >to_timestamp('15:12:02.020.001230', 'HH:MI:SS.MS.US')</TT
1144 >
1145        is 15 hours, 12 minutes, and 2 seconds + 20 milliseconds +
1146        1230 microseconds = 2.021230 seconds.
1147       </P
1148 ></LI
1149 ></UL
1150 ><P>
1151    </P
1152 ><P
1153 >   <A
1154 HREF="functions-formatting.html#FUNCTIONS-FORMATTING-NUMERIC-TABLE"
1155 >Table 9-23</A
1156 > shows the
1157    template patterns available for formatting numeric values.
1158   </P
1159 ><DIV
1160 CLASS="TABLE"
1161 ><A
1162 NAME="FUNCTIONS-FORMATTING-NUMERIC-TABLE"
1163 ></A
1164 ><P
1165 ><B
1166 >Table 9-23. Template Patterns for Numeric Formatting</B
1167 ></P
1168 ><TABLE
1169 BORDER="1"
1170 CLASS="CALSTABLE"
1171 ><COL><COL><THEAD
1172 ><TR
1173 ><TH
1174 >Pattern</TH
1175 ><TH
1176 >Description</TH
1177 ></TR
1178 ></THEAD
1179 ><TBODY
1180 ><TR
1181 ><TD
1182 ><TT
1183 CLASS="LITERAL"
1184 >9</TT
1185 ></TD
1186 ><TD
1187 >value with the specified number of digits</TD
1188 ></TR
1189 ><TR
1190 ><TD
1191 ><TT
1192 CLASS="LITERAL"
1193 >0</TT
1194 ></TD
1195 ><TD
1196 >value with leading zeros</TD
1197 ></TR
1198 ><TR
1199 ><TD
1200 ><TT
1201 CLASS="LITERAL"
1202 >.</TT
1203 > (period)</TD
1204 ><TD
1205 >decimal point</TD
1206 ></TR
1207 ><TR
1208 ><TD
1209 ><TT
1210 CLASS="LITERAL"
1211 >,</TT
1212 > (comma)</TD
1213 ><TD
1214 >group (thousand) separator</TD
1215 ></TR
1216 ><TR
1217 ><TD
1218 ><TT
1219 CLASS="LITERAL"
1220 >PR</TT
1221 ></TD
1222 ><TD
1223 >negative value in angle brackets</TD
1224 ></TR
1225 ><TR
1226 ><TD
1227 ><TT
1228 CLASS="LITERAL"
1229 >S</TT
1230 ></TD
1231 ><TD
1232 >sign anchored to number (uses locale)</TD
1233 ></TR
1234 ><TR
1235 ><TD
1236 ><TT
1237 CLASS="LITERAL"
1238 >L</TT
1239 ></TD
1240 ><TD
1241 >currency symbol (uses locale)</TD
1242 ></TR
1243 ><TR
1244 ><TD
1245 ><TT
1246 CLASS="LITERAL"
1247 >D</TT
1248 ></TD
1249 ><TD
1250 >decimal point (uses locale)</TD
1251 ></TR
1252 ><TR
1253 ><TD
1254 ><TT
1255 CLASS="LITERAL"
1256 >G</TT
1257 ></TD
1258 ><TD
1259 >group separator (uses locale)</TD
1260 ></TR
1261 ><TR
1262 ><TD
1263 ><TT
1264 CLASS="LITERAL"
1265 >MI</TT
1266 ></TD
1267 ><TD
1268 >minus sign in specified position (if number &lt; 0)</TD
1269 ></TR
1270 ><TR
1271 ><TD
1272 ><TT
1273 CLASS="LITERAL"
1274 >PL</TT
1275 ></TD
1276 ><TD
1277 >plus sign in specified position (if number &gt; 0)</TD
1278 ></TR
1279 ><TR
1280 ><TD
1281 ><TT
1282 CLASS="LITERAL"
1283 >SG</TT
1284 ></TD
1285 ><TD
1286 >plus/minus sign in specified position</TD
1287 ></TR
1288 ><TR
1289 ><TD
1290 ><TT
1291 CLASS="LITERAL"
1292 >RN</TT
1293 ></TD
1294 ><TD
1295 >roman numeral (input between 1 and 3999)</TD
1296 ></TR
1297 ><TR
1298 ><TD
1299 ><TT
1300 CLASS="LITERAL"
1301 >TH</TT
1302 > or <TT
1303 CLASS="LITERAL"
1304 >th</TT
1305 ></TD
1306 ><TD
1307 >ordinal number suffix</TD
1308 ></TR
1309 ><TR
1310 ><TD
1311 ><TT
1312 CLASS="LITERAL"
1313 >V</TT
1314 ></TD
1315 ><TD
1316 >shift specified number of digits (see notes)</TD
1317 ></TR
1318 ><TR
1319 ><TD
1320 ><TT
1321 CLASS="LITERAL"
1322 >EEEE</TT
1323 ></TD
1324 ><TD
1325 >scientific notation (not implemented yet)</TD
1326 ></TR
1327 ></TBODY
1328 ></TABLE
1329 ></DIV
1330 ><P
1331 >    Usage notes for the numeric formatting:
1332
1333     <P
1334 ></P
1335 ></P><UL
1336 ><LI
1337 ><P
1338 >       A sign formatted using <TT
1339 CLASS="LITERAL"
1340 >SG</TT
1341 >, <TT
1342 CLASS="LITERAL"
1343 >PL</TT
1344 >, or
1345        <TT
1346 CLASS="LITERAL"
1347 >MI</TT
1348 > is not anchored to
1349        the number; for example,
1350        <TT
1351 CLASS="LITERAL"
1352 >to_char(-12, 'S9999')</TT
1353 > produces <TT
1354 CLASS="LITERAL"
1355 >'&nbsp;&nbsp;-12'</TT
1356 >,
1357        but <TT
1358 CLASS="LITERAL"
1359 >to_char(-12, 'MI9999')</TT
1360 > produces <TT
1361 CLASS="LITERAL"
1362 >'-&nbsp;&nbsp;12'</TT
1363 >.
1364        The Oracle implementation does not allow the use of
1365        <TT
1366 CLASS="LITERAL"
1367 >MI</TT
1368 > ahead of <TT
1369 CLASS="LITERAL"
1370 >9</TT
1371 >, but rather
1372        requires that <TT
1373 CLASS="LITERAL"
1374 >9</TT
1375 > precede
1376        <TT
1377 CLASS="LITERAL"
1378 >MI</TT
1379 >.
1380       </P
1381 ></LI
1382 ><LI
1383 ><P
1384 >       <TT
1385 CLASS="LITERAL"
1386 >9</TT
1387 > results in a value with the same number of
1388        digits as there are <TT
1389 CLASS="LITERAL"
1390 >9</TT
1391 >s. If a digit is
1392        not available it outputs a space.
1393       </P
1394 ></LI
1395 ><LI
1396 ><P
1397 >       <TT
1398 CLASS="LITERAL"
1399 >TH</TT
1400 > does not convert values less than zero
1401        and does not convert fractional numbers.
1402       </P
1403 ></LI
1404 ><LI
1405 ><P
1406 >       <TT
1407 CLASS="LITERAL"
1408 >PL</TT
1409 >, <TT
1410 CLASS="LITERAL"
1411 >SG</TT
1412 >, and
1413        <TT
1414 CLASS="LITERAL"
1415 >TH</TT
1416 > are <SPAN
1417 CLASS="PRODUCTNAME"
1418 >PostgreSQL</SPAN
1419 >
1420        extensions.
1421       </P
1422 ></LI
1423 ><LI
1424 ><P
1425 >       <TT
1426 CLASS="LITERAL"
1427 >V</TT
1428 > effectively
1429        multiplies the input values by
1430        <TT
1431 CLASS="LITERAL"
1432 >10^<VAR
1433 CLASS="REPLACEABLE"
1434 >n</VAR
1435 ></TT
1436 >, where
1437        <VAR
1438 CLASS="REPLACEABLE"
1439 >n</VAR
1440 > is the number of digits following
1441        <TT
1442 CLASS="LITERAL"
1443 >V</TT
1444 >.
1445        <CODE
1446 CLASS="FUNCTION"
1447 >to_char</CODE
1448 > does not support the use of
1449        <TT
1450 CLASS="LITERAL"
1451 >V</TT
1452 > combined with a decimal point.
1453        (E.g., <TT
1454 CLASS="LITERAL"
1455 >99.9V99</TT
1456 > is not allowed.)
1457       </P
1458 ></LI
1459 ></UL
1460 ><P>
1461    </P
1462 ><P
1463 >   <A
1464 HREF="functions-formatting.html#FUNCTIONS-FORMATTING-EXAMPLES-TABLE"
1465 >Table 9-24</A
1466 > shows some
1467    examples of the use of the <CODE
1468 CLASS="FUNCTION"
1469 >to_char</CODE
1470 > function.
1471   </P
1472 ><DIV
1473 CLASS="TABLE"
1474 ><A
1475 NAME="FUNCTIONS-FORMATTING-EXAMPLES-TABLE"
1476 ></A
1477 ><P
1478 ><B
1479 >Table 9-24. <CODE
1480 CLASS="FUNCTION"
1481 >to_char</CODE
1482 > Examples</B
1483 ></P
1484 ><TABLE
1485 BORDER="1"
1486 CLASS="CALSTABLE"
1487 ><COL><COL><THEAD
1488 ><TR
1489 ><TH
1490 >Expression</TH
1491 ><TH
1492 >Result</TH
1493 ></TR
1494 ></THEAD
1495 ><TBODY
1496 ><TR
1497 ><TD
1498 ><TT
1499 CLASS="LITERAL"
1500 >to_char(current_timestamp, 'Day,&nbsp;DD&nbsp;&nbsp;HH12:MI:SS')</TT
1501 ></TD
1502 ><TD
1503 ><TT
1504 CLASS="LITERAL"
1505 >'Tuesday&nbsp;&nbsp;,&nbsp;06&nbsp;&nbsp;05:39:18'</TT
1506 ></TD
1507 ></TR
1508 ><TR
1509 ><TD
1510 ><TT
1511 CLASS="LITERAL"
1512 >to_char(current_timestamp, 'FMDay,&nbsp;FMDD&nbsp;&nbsp;HH12:MI:SS')</TT
1513 ></TD
1514 ><TD
1515 ><TT
1516 CLASS="LITERAL"
1517 >'Tuesday,&nbsp;6&nbsp;&nbsp;05:39:18'</TT
1518 ></TD
1519 ></TR
1520 ><TR
1521 ><TD
1522 ><TT
1523 CLASS="LITERAL"
1524 >to_char(-0.1, '99.99')</TT
1525 ></TD
1526 ><TD
1527 ><TT
1528 CLASS="LITERAL"
1529 >'&nbsp;&nbsp;-.10'</TT
1530 ></TD
1531 ></TR
1532 ><TR
1533 ><TD
1534 ><TT
1535 CLASS="LITERAL"
1536 >to_char(-0.1, 'FM9.99')</TT
1537 ></TD
1538 ><TD
1539 ><TT
1540 CLASS="LITERAL"
1541 >'-.1'</TT
1542 ></TD
1543 ></TR
1544 ><TR
1545 ><TD
1546 ><TT
1547 CLASS="LITERAL"
1548 >to_char(0.1, '0.9')</TT
1549 ></TD
1550 ><TD
1551 ><TT
1552 CLASS="LITERAL"
1553 >'&nbsp;0.1'</TT
1554 ></TD
1555 ></TR
1556 ><TR
1557 ><TD
1558 ><TT
1559 CLASS="LITERAL"
1560 >to_char(12, '9990999.9')</TT
1561 ></TD
1562 ><TD
1563 ><TT
1564 CLASS="LITERAL"
1565 >'&nbsp;&nbsp;&nbsp;&nbsp;0012.0'</TT
1566 ></TD
1567 ></TR
1568 ><TR
1569 ><TD
1570 ><TT
1571 CLASS="LITERAL"
1572 >to_char(12, 'FM9990999.9')</TT
1573 ></TD
1574 ><TD
1575 ><TT
1576 CLASS="LITERAL"
1577 >'0012.'</TT
1578 ></TD
1579 ></TR
1580 ><TR
1581 ><TD
1582 ><TT
1583 CLASS="LITERAL"
1584 >to_char(485, '999')</TT
1585 ></TD
1586 ><TD
1587 ><TT
1588 CLASS="LITERAL"
1589 >'&nbsp;485'</TT
1590 ></TD
1591 ></TR
1592 ><TR
1593 ><TD
1594 ><TT
1595 CLASS="LITERAL"
1596 >to_char(-485, '999')</TT
1597 ></TD
1598 ><TD
1599 ><TT
1600 CLASS="LITERAL"
1601 >'-485'</TT
1602 ></TD
1603 ></TR
1604 ><TR
1605 ><TD
1606 ><TT
1607 CLASS="LITERAL"
1608 >to_char(485, '9&nbsp;9&nbsp;9')</TT
1609 ></TD
1610 ><TD
1611 ><TT
1612 CLASS="LITERAL"
1613 >'&nbsp;4&nbsp;8&nbsp;5'</TT
1614 ></TD
1615 ></TR
1616 ><TR
1617 ><TD
1618 ><TT
1619 CLASS="LITERAL"
1620 >to_char(1485, '9,999')</TT
1621 ></TD
1622 ><TD
1623 ><TT
1624 CLASS="LITERAL"
1625 >'&nbsp;1,485'</TT
1626 ></TD
1627 ></TR
1628 ><TR
1629 ><TD
1630 ><TT
1631 CLASS="LITERAL"
1632 >to_char(1485, '9G999')</TT
1633 ></TD
1634 ><TD
1635 ><TT
1636 CLASS="LITERAL"
1637 >'&nbsp;1&nbsp;485'</TT
1638 ></TD
1639 ></TR
1640 ><TR
1641 ><TD
1642 ><TT
1643 CLASS="LITERAL"
1644 >to_char(148.5, '999.999')</TT
1645 ></TD
1646 ><TD
1647 ><TT
1648 CLASS="LITERAL"
1649 >'&nbsp;148.500'</TT
1650 ></TD
1651 ></TR
1652 ><TR
1653 ><TD
1654 ><TT
1655 CLASS="LITERAL"
1656 >to_char(148.5, 'FM999.999')</TT
1657 ></TD
1658 ><TD
1659 ><TT
1660 CLASS="LITERAL"
1661 >'148.5'</TT
1662 ></TD
1663 ></TR
1664 ><TR
1665 ><TD
1666 ><TT
1667 CLASS="LITERAL"
1668 >to_char(148.5, 'FM999.990')</TT
1669 ></TD
1670 ><TD
1671 ><TT
1672 CLASS="LITERAL"
1673 >'148.500'</TT
1674 ></TD
1675 ></TR
1676 ><TR
1677 ><TD
1678 ><TT
1679 CLASS="LITERAL"
1680 >to_char(148.5, '999D999')</TT
1681 ></TD
1682 ><TD
1683 ><TT
1684 CLASS="LITERAL"
1685 >'&nbsp;148,500'</TT
1686 ></TD
1687 ></TR
1688 ><TR
1689 ><TD
1690 ><TT
1691 CLASS="LITERAL"
1692 >to_char(3148.5, '9G999D999')</TT
1693 ></TD
1694 ><TD
1695 ><TT
1696 CLASS="LITERAL"
1697 >'&nbsp;3&nbsp;148,500'</TT
1698 ></TD
1699 ></TR
1700 ><TR
1701 ><TD
1702 ><TT
1703 CLASS="LITERAL"
1704 >to_char(-485, '999S')</TT
1705 ></TD
1706 ><TD
1707 ><TT
1708 CLASS="LITERAL"
1709 >'485-'</TT
1710 ></TD
1711 ></TR
1712 ><TR
1713 ><TD
1714 ><TT
1715 CLASS="LITERAL"
1716 >to_char(-485, '999MI')</TT
1717 ></TD
1718 ><TD
1719 ><TT
1720 CLASS="LITERAL"
1721 >'485-'</TT
1722 ></TD
1723 ></TR
1724 ><TR
1725 ><TD
1726 ><TT
1727 CLASS="LITERAL"
1728 >to_char(485, '999MI')</TT
1729 ></TD
1730 ><TD
1731 ><TT
1732 CLASS="LITERAL"
1733 >'485&nbsp;'</TT
1734 ></TD
1735 ></TR
1736 ><TR
1737 ><TD
1738 ><TT
1739 CLASS="LITERAL"
1740 >to_char(485, 'FM999MI')</TT
1741 ></TD
1742 ><TD
1743 ><TT
1744 CLASS="LITERAL"
1745 >'485'</TT
1746 ></TD
1747 ></TR
1748 ><TR
1749 ><TD
1750 ><TT
1751 CLASS="LITERAL"
1752 >to_char(485, 'PL999')</TT
1753 ></TD
1754 ><TD
1755 ><TT
1756 CLASS="LITERAL"
1757 >'+485'</TT
1758 ></TD
1759 ></TR
1760 ><TR
1761 ><TD
1762 ><TT
1763 CLASS="LITERAL"
1764 >to_char(485, 'SG999')</TT
1765 ></TD
1766 ><TD
1767 ><TT
1768 CLASS="LITERAL"
1769 >'+485'</TT
1770 ></TD
1771 ></TR
1772 ><TR
1773 ><TD
1774 ><TT
1775 CLASS="LITERAL"
1776 >to_char(-485, 'SG999')</TT
1777 ></TD
1778 ><TD
1779 ><TT
1780 CLASS="LITERAL"
1781 >'-485'</TT
1782 ></TD
1783 ></TR
1784 ><TR
1785 ><TD
1786 ><TT
1787 CLASS="LITERAL"
1788 >to_char(-485, '9SG99')</TT
1789 ></TD
1790 ><TD
1791 ><TT
1792 CLASS="LITERAL"
1793 >'4-85'</TT
1794 ></TD
1795 ></TR
1796 ><TR
1797 ><TD
1798 ><TT
1799 CLASS="LITERAL"
1800 >to_char(-485, '999PR')</TT
1801 ></TD
1802 ><TD
1803 ><TT
1804 CLASS="LITERAL"
1805 >'&lt;485&gt;'</TT
1806 ></TD
1807 ></TR
1808 ><TR
1809 ><TD
1810 ><TT
1811 CLASS="LITERAL"
1812 >to_char(485, 'L999')</TT
1813 ></TD
1814 ><TD
1815 ><TT
1816 CLASS="LITERAL"
1817 >'DM&nbsp;485</TT
1818 ></TD
1819 ></TR
1820 ><TR
1821 ><TD
1822 ><TT
1823 CLASS="LITERAL"
1824 >to_char(485, 'RN')</TT
1825 ></TD
1826 ><TD
1827 ><TT
1828 CLASS="LITERAL"
1829 >'&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;CDLXXXV'</TT
1830 ></TD
1831 ></TR
1832 ><TR
1833 ><TD
1834 ><TT
1835 CLASS="LITERAL"
1836 >to_char(485, 'FMRN')</TT
1837 ></TD
1838 ><TD
1839 ><TT
1840 CLASS="LITERAL"
1841 >'CDLXXXV'</TT
1842 ></TD
1843 ></TR
1844 ><TR
1845 ><TD
1846 ><TT
1847 CLASS="LITERAL"
1848 >to_char(5.2, 'FMRN')</TT
1849 ></TD
1850 ><TD
1851 ><TT
1852 CLASS="LITERAL"
1853 >'V'</TT
1854 ></TD
1855 ></TR
1856 ><TR
1857 ><TD
1858 ><TT
1859 CLASS="LITERAL"
1860 >to_char(482, '999th')</TT
1861 ></TD
1862 ><TD
1863 ><TT
1864 CLASS="LITERAL"
1865 >'&nbsp;482nd'</TT
1866 ></TD
1867 ></TR
1868 ><TR
1869 ><TD
1870 ><TT
1871 CLASS="LITERAL"
1872 >to_char(485, '"Good&nbsp;number:"999')</TT
1873 ></TD
1874 ><TD
1875 ><TT
1876 CLASS="LITERAL"
1877 >'Good&nbsp;number:&nbsp;485'</TT
1878 ></TD
1879 ></TR
1880 ><TR
1881 ><TD
1882 ><TT
1883 CLASS="LITERAL"
1884 >to_char(485.8, '"Pre:"999"&nbsp;Post:"&nbsp;.999')</TT
1885 ></TD
1886 ><TD
1887 ><TT
1888 CLASS="LITERAL"
1889 >'Pre:&nbsp;485&nbsp;Post:&nbsp;.800'</TT
1890 ></TD
1891 ></TR
1892 ><TR
1893 ><TD
1894 ><TT
1895 CLASS="LITERAL"
1896 >to_char(12, '99V999')</TT
1897 ></TD
1898 ><TD
1899 ><TT
1900 CLASS="LITERAL"
1901 >'&nbsp;12000'</TT
1902 ></TD
1903 ></TR
1904 ><TR
1905 ><TD
1906 ><TT
1907 CLASS="LITERAL"
1908 >to_char(12.4, '99V999')</TT
1909 ></TD
1910 ><TD
1911 ><TT
1912 CLASS="LITERAL"
1913 >'&nbsp;12400'</TT
1914 ></TD
1915 ></TR
1916 ><TR
1917 ><TD
1918 ><TT
1919 CLASS="LITERAL"
1920 >to_char(12.45, '99V9')</TT
1921 ></TD
1922 ><TD
1923 ><TT
1924 CLASS="LITERAL"
1925 >'&nbsp;125'</TT
1926 ></TD
1927 ></TR
1928 ></TBODY
1929 ></TABLE
1930 ></DIV
1931 ></DIV
1932 ><DIV
1933 CLASS="NAVFOOTER"
1934 ><HR
1935 ALIGN="LEFT"
1936 WIDTH="100%"><TABLE
1937 SUMMARY="Footer navigation table"
1938 WIDTH="100%"
1939 BORDER="0"
1940 CELLPADDING="0"
1941 CELLSPACING="0"
1942 ><TR
1943 ><TD
1944 WIDTH="33%"
1945 ALIGN="left"
1946 VALIGN="top"
1947 ><A
1948 HREF="functions-matching.html"
1949 ACCESSKEY="P"
1950 >Prev</A
1951 ></TD
1952 ><TD
1953 WIDTH="34%"
1954 ALIGN="center"
1955 VALIGN="top"
1956 ><A
1957 HREF="index.html"
1958 ACCESSKEY="H"
1959 >Home</A
1960 ></TD
1961 ><TD
1962 WIDTH="33%"
1963 ALIGN="right"
1964 VALIGN="top"
1965 ><A
1966 HREF="functions-datetime.html"
1967 ACCESSKEY="N"
1968 >Next</A
1969 ></TD
1970 ></TR
1971 ><TR
1972 ><TD
1973 WIDTH="33%"
1974 ALIGN="left"
1975 VALIGN="top"
1976 >Pattern Matching</TD
1977 ><TD
1978 WIDTH="34%"
1979 ALIGN="center"
1980 VALIGN="top"
1981 ><A
1982 HREF="functions.html"
1983 ACCESSKEY="U"
1984 >Up</A
1985 ></TD
1986 ><TD
1987 WIDTH="33%"
1988 ALIGN="right"
1989 VALIGN="top"
1990 >Date/Time Functions and Operators</TD
1991 ></TR
1992 ></TABLE
1993 ></DIV
1994 ></BODY
1995 ></HTML
1996 >