{ "content": [ { "type": "text", "text": "# Date::Format (perldoc)\n\n## NAME\n\nDate::Format - Date formating subroutines\n\n## SYNOPSIS\n\nuse Date::Format;\n@lt = localtime(time);\nprint time2str($template, time);\nprint strftime($template, @lt);\nprint time2str($template, time, $zone);\nprint strftime($template, @lt, $zone);\nprint ctime(time);\nprint asctime(@lt);\nprint ctime(time, $zone);\nprint asctime(@lt, $zone);\n\n## DESCRIPTION\n\nThis module provides routines to format dates into ASCII strings. They correspond to the C\nlibrary routines \"strftime\" and \"ctime\".\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION** (4 subsections)\n- **MULTI-LANGUAGE SUPPORT**\n- **CONVERSION SPECIFICATION**\n- **LIMITATION**\n- **AUTHOR**\n- **COPYRIGHT**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n" } ], "structuredContent": { "command": "Date::Format", "section": "", "mode": "perldoc", "summary": "Date::Format - Date formating subroutines", "synopsis": "use Date::Format;\n@lt = localtime(time);\nprint time2str($template, time);\nprint strftime($template, @lt);\nprint time2str($template, time, $zone);\nprint strftime($template, @lt, $zone);\nprint ctime(time);\nprint asctime(@lt);\nprint ctime(time, $zone);\nprint asctime(@lt, $zone);", "tldr_summary": null, "tldr_examples": [], "tldr_source": null, "flags": [], "examples": [], "see_also": [], "section_outline": [ { "name": "NAME", "lines": 2, "subsections": [] }, { "name": "SYNOPSIS", "lines": 16, "subsections": [] }, { "name": "DESCRIPTION", "lines": 3, "subsections": [ { "name": "time2str", "lines": 4 }, { "name": "strftime", "lines": 3 }, { "name": "ctime", "lines": 3 }, { "name": "asctime", "lines": 3 } ] }, { "name": "MULTI-LANGUAGE SUPPORT", "lines": 8, "subsections": [] }, { "name": "CONVERSION SPECIFICATION", "lines": 48, "subsections": [] }, { "name": "LIMITATION", "lines": 3, "subsections": [] }, { "name": "AUTHOR", "lines": 2, "subsections": [] }, { "name": "COPYRIGHT", "lines": 3, "subsections": [] } ], "sections": { "NAME": { "content": "Date::Format - Date formating subroutines\n", "subsections": [] }, "SYNOPSIS": { "content": "use Date::Format;\n\n@lt = localtime(time);\n\nprint time2str($template, time);\nprint strftime($template, @lt);\n\nprint time2str($template, time, $zone);\nprint strftime($template, @lt, $zone);\n\nprint ctime(time);\nprint asctime(@lt);\n\nprint ctime(time, $zone);\nprint asctime(@lt, $zone);\n", "subsections": [] }, "DESCRIPTION": { "content": "This module provides routines to format dates into ASCII strings. They correspond to the C\nlibrary routines \"strftime\" and \"ctime\".\n", "subsections": [ { "name": "time2str", "content": "\"time2str\" converts \"TIME\" into an ASCII string using the conversion specification given in\n\"TEMPLATE\". \"ZONE\" if given specifies the zone which the output is required to be in, \"ZONE\"\ndefaults to your current zone.\n" }, { "name": "strftime", "content": "\"strftime\" is similar to \"time2str\" with the exception that the time is passed as an array,\nsuch as the array returned by \"localtime\".\n" }, { "name": "ctime", "content": "\"ctime\" calls \"time2str\" with the given arguments using the conversion specification \"%a %b\n%e %T %Y\\n\"\n" }, { "name": "asctime", "content": "\"asctime\" calls \"time2str\" with the given arguments using the conversion specification \"%a\n%b %e %T %Y\\n\"\n" } ] }, "MULTI-LANGUAGE SUPPORT": { "content": "Date::Format is capable of formating into several languages by creating a language specific\nobject and calling methods, see Date::Language\n\nmy $lang = Date::Language->new('German');\n$lang->time2str(\"%a %b %e %T %Y\\n\", time);\n\nI am open to suggestions on this.\n", "subsections": [] }, "CONVERSION SPECIFICATION": { "content": "Each conversion specification is replaced by appropriate characters as described in the\nfollowing list. The appropriate characters are determined by the LCTIME category of the\nprogram's locale.\n\n%% PERCENT\n%a day of the week abbr\n%A day of the week\n%b month abbr\n%B month\n%c MM/DD/YY HH:MM:SS\n%C ctime format: Sat Nov 19 21:05:57 1994\n%d numeric day of the month, with leading zeros (eg 01..31)\n%e like %d, but a leading zero is replaced by a space (eg 1..32)\n%D MM/DD/YY\n%G GPS week number (weeks since January 6, 1980)\n%h month abbr\n%H hour, 24 hour clock, leading 0's)\n%I hour, 12 hour clock, leading 0's)\n%j day of the year\n%k hour\n%l hour, 12 hour clock\n%L month number, starting with 1\n%m month number, starting with 01\n%M minute, leading 0's\n%n NEWLINE\n%o ornate day of month -- \"1st\", \"2nd\", \"25th\", etc.\n%p AM or PM\n%P am or pm (Yes %p and %P are backwards :)\n%q Quarter number, starting with 1\n%r time format: 09:05:57 PM\n%R time format: 21:05\n%s seconds since the Epoch, UCT\n%S seconds, leading 0's\n%t TAB\n%T time format: 21:05:57\n%U week number, Sunday as first day of week\n%w day of the week, numerically, Sunday == 0\n%W week number, Monday as first day of week\n%x date format: 11/19/94\n%X time format: 21:05:57\n%y year (2 digits)\n%Y year (4 digits)\n%Z timezone in ascii. eg: PST\n%z timezone in format -/+0000\n\n%d, %e, %H, %I, %j, %k, %l, %m, %M, %q, %y and %Y can be output in Roman numerals by prefixing\nthe letter with \"O\", e.g. %OY will output the year as roman numerals.\n", "subsections": [] }, "LIMITATION": { "content": "The functions in this module are limited to the time range that can be represented by the timet\ndata type, i.e. 1901-12-13 20:45:53 GMT to 2038-01-19 03:14:07 GMT.\n", "subsections": [] }, "AUTHOR": { "content": "Graham Barr \n", "subsections": [] }, "COPYRIGHT": { "content": "Copyright (c) 1995-2009 Graham Barr. This program is free software; you can redistribute it\nand/or modify it under the same terms as Perl itself.\n", "subsections": [] } } } }