dk.ttcal

Date classes (originally from TikTok).

class dk.ttcal.CompareMixin

Mixin class that defines comparison operators, by comparing the (year, month, day) tuple returned by datetuple(). This makes Year() <= Month() <= Week() <= Today().

timetuple()

Create timetuple from datetuple. (to interact with datetime objects).

class dk.ttcal.Day

A calendar date.

Month

Return a Month object representing the month self belongs to.

Year

Return a Year object representing the year self belongs to.

code

One letter code representing the dayname.

compare(other)

Return how similar self is to other.

date()

Excplicitly convert to datetime.date.

datetime(hour=0, minute=0, second=0)

Extend self to datetime.

datetuple()

Return year, month, day.

day_code = ['M', 'U', 'W', 'H', 'F', 'A', 'S']

day_name = [u'mandag', u'tirsdag', u'onsdag', u'torsdag', u'fredag', u'l\xf8rdag', u's\xf8ndag']

dayname

The semi-localized name of self.

display

Return the ‘class’ of self.

first

Define self == self.first for polymorphic usage with other classes.

format(fmt=None)

Emulate Django’s date filter.

classmethod from_idtag(tag)

Return Day from idtag.

static get_day_name(daynum, length=None)

Return dayname for daynum.

idtag

Return the idtag for self: dyyyymmddmm.

in_month

True iff the day is in its month.

isoyear

Return the isoyear of self.

last

Define self == self.last for polymorphic usage with other classes.

next()

classmethod parse(strval)

Parse date value from a string. Allowed syntax include:

yyyy-mm-dd, yyyy-m-dd, yyyy-mm-d, yyyy-m-d dd-mm-yyyy, etc. dd/mm/yyyy, ... dd.mm.yyyy, ... ddmmyyyy

prev()

special

True if the database has an entry for this date (sets special_hours).

today

True if self is today.

week

Return a Week object representing the week self belongs to.

weekday

True if self is a weekday.

weekend

True if self is Saturday or Sunday.

weeknum

Return the isoweek of self.

class dk.ttcal.Days(start, end, start_week=False)

A contigous set of days.

first

1st day

last

last day

class dk.ttcal.Duration

A duration of time.

duration_tuple()

Return self as hours, minutes, seconds.

classmethod parse(txt)

Parse a textual representation into a Duration object. Format HHH:MM:SS.

classmethod sum(sequence, start=None)

Return the sum of sequence. (built-in sum only works with numbers).

toint()

Convert self to integer.

class dk.ttcal.Month(year=None, month=None, date=None)

A calendar month.

Month

Year

Return a Year object for the year-part of this month.

datetuple()

First date in month.

daycount

The number of days in this month (as an int).

dayiter()

days()

Return a list of days (class:ttcal.Day) in this month.

first

First day in month.

format(fmt=None)

Format according to format string. Default format is monthname, four-digit-year.

classmethod from_date(d)

Create a Month from the date d.

classmethod from_idtag(tag)

Parse idtag into class:Month.

idtag()

Return a text representation that is parsable by the from_idtag function (above), and is useable as part of an url.

last

Last day in month.

mark(d, value='mark', method='replace')

marked_days()

month_name = ['', 'Januar', 'Februar', 'Mars', 'April', 'Mai', 'Juni', 'Juli', 'August', 'September', 'Oktober', 'November', 'Desember']

next()

Next month.

numdays()

The number of days in the month.

classmethod parse(txt)

Parse a textual representation into a Month object. Format YYYY-MM?

prev()

Previous month.

class dk.ttcal.RangeMixin

Requires other class to define .first and .last attributes.

between_tuple(period)

Return a tuple of datetimes that is convenient for sql between queries.

middle

Return the day that splits the date range in half.

range()

Return an iterator for the range of self.

class dk.ttcal.Today

Special subclass for today’s date.

today = True

class dk.ttcal.Week(days, month)

current

True if today is in week.

datetuple()

First day of this week.

first

1st day of week.

classmethod from_idtag(tag)

idtag()

last

Last day of week.

until_today()

classmethod weeknum(n, year=None)

class dk.ttcal.Weeks(start, end)

datetuple()

First day of first week.

dayiter()

Iterate over all days in all the weeks.

first

First day in first week.

last

Last day in last week.

class dk.ttcal.Year(year=None)

H1

First half of this year.

H2

Last half of this year.

Month

For orthogonality in the api.

Q1

1st quarter.

Q2

2nd quarter.

Q3

3rd quarter.

Q4

4th quarter.

Year

april

august

datetuple()

January 1.

dayiter()

december

february

first

First day of first month.

format(fmt=None)

Format according to format string. Default format is monthname, four-digit-year.

classmethod from_idtag(tag)

Year tags have the lower-case letter y + the four digit year, eg. y2008.

halves()

Both halves of the year.

idtag()

Year tags have the lower-case letter y + the four digit year, eg. y2008.

january

july

june

last

Last day of last month.

march

mark(d, value='mark')

mark_period(p, value='mark')

marked_days()

may

next()

Next year.

november

october

prev()

Previous year.

quarters()

Every quarter in this year.

rows()

rows4()

september

dk.ttcal.chop(it, n)

Chop iterator into n size chuchks.

dk.ttcal.from_idtag(idtag)

Return a class from idtag.

dk.ttcal.isoweek(year, week)

Iterate over the days in isoweek week of year.