Skip to content
This repository has been archived by the owner on Nov 28, 2023. It is now read-only.
/ gocept.month Public archive

A datatype which stores a year and a month.

License

Notifications You must be signed in to change notification settings

gocept/gocept.month

Repository files navigation

gocept.month

https://coveralls.io/repos/github/gocept/gocept.month/badge.svg?branch=master pre-commit.ci status

A datatype which stores a year and a month.

This package provides the data type Month (typical usage: Month(4, 2003)), which supports conversion to and from strings, as well as a zope.schema field and widgets for both zope.formlib and z3c.form.

To use the month field, <include package="gocept.month"/> and declare a schema like this:

>>> import gocept.month
>>> import zope.interface
>>> import zope.schema
>>> class IContract(zope.interface.Interface):
...     title = zope.schema.TextLine(title=u"Contract title")
...     start = gocept.month.MonthField(title=u"Starting date")
...     end = gocept.month.MonthField(title=u"Ending date")

To use the form widgets, you need to require the form setuptools extra (i.e. gocept.month[form]), and <include package="gocept.month.browser"/> in your ZCML.