From 598090797c2cb3a4fe945d2eacd3eca42a0cfe5d Mon Sep 17 00:00:00 2001 From: Tom Ryder Date: Sun, 31 May 2020 01:15:36 +1200 Subject: First version from tejr dotfiles v9.12.0 --- doc/put_date.txt | 44 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 44 insertions(+) create mode 100644 doc/put_date.txt (limited to 'doc') diff --git a/doc/put_date.txt b/doc/put_date.txt new file mode 100644 index 0000000..9fb7021 --- /dev/null +++ b/doc/put_date.txt @@ -0,0 +1,44 @@ +*put_date.txt* For Vim version 7.0 Last change: 2020 May 31 + +DESCRIPTION *put_date* + +This plugin provides a convenience wrapper around `strftime()` to insert the +current date and time in the buffer, defaulting to RFC2822 format, and +requiring neither percent signs nor quoting for any specified format. +> + :PutDate + Sun, 31 May 2020 01:04:41 +1200 + :PutDate d/m/Y + 31/05/2020 +< +An attempt to use the UTC time zone rather than the local time zone is made if +a bang is added: +> + :PutDate! + Sat, 30 May 2020 13:04:14 +0000 + :PutDate! + 13 +< +This time zone switching only works reliably on Unix with Vim v8.2, or Vim 8.1 +with patch 1567: + +REQUIREMENTS *put_date-requirements* + +This plugin only loads if 'compatible' is not set. Strictly speaking, it also +depends on the underlying system's implementation of the POSIX `strftime(3)` +function, just as Vim's own |strftime()| does. It will not behave identically +between systems. + +In particular, the time zone switching only works reliably on Unix, and it's +broken there between patches 8.1.1313 and 8.1.1567. See |version8.txt| for +details. At the time of writing, it's still broken on Windows since 8.1.1313. + +AUTHOR *put_date-author* + +Written and maintained by Tom Ryder . + +LICENSE *put_date-license* + +Licensed for distribution under the same terms as Vim itself (see |license|). + + vim:tw=78:ts=8:ft=help:norl: -- cgit v1.2.3