Skip to content


Subversion checkout URL

You can clone with
Download ZIP
VimL Makefile
Latest commit 32c474d @mattn Merge pull request #27 from osleg/master
Added option to customize calendar's diary file extension
Failed to load latest commit information.
autoload Removed unneeded expand()
doc Correct misspelling
plugin Issue #10
.gitignore Add .gitignore
Makefile Add Makefile Fixes doc, close #16
calendar.vim.vimup Fix vimup source


calendar.vim creates a calendar window you can use within vim. It is useful in its own right as a calendar-inside-vim. It also provides hooks to customise its behaviour, making it a good basis for writing new plugins which require calendar functionality (see :help calendar-hooks for more information).


You can install calendar.vim in the usual way, by copying the contents of the plugin, autoload and doc directories into the equivalent directories inside .vim.

Alternatively, if you manage your plugins using pathogen.vim, you can simply clone into the bundle directory:

cd ~/.vim/bundle
git clone git://

Or, using submodules:

cd ~/.vim
git submodule add git:// bundle/calendar-vim


Bring up a calendar based on today's date in a vertically split window:


Bring up a calendar showing November, 1991 (The month Vim was first released):

:Calendar 1991 11

The above calendars can alternatively be displayed in a horizontally split window:


Bring up a full-screen:


Fast mappings are provided:

  • <LocalLeader>cal: Vertically-split calendar
  • <LocalLeader>caL: Horizontally-split calendar

For full documentation, install the plugin and run :help calendar from within Vim.

Something went wrong with that request. Please try again.