mungedb-aggregate/lib/pipeline/expressions/DayOfYearExpression.js

"use strict";
var DayOfYearExpression = module.exports = (function(){
	// CONSTRUCTOR
	/**
	 * Get the DayOfYear from a date.
	 *
	 * @class DayOfYearExpression
	 * @namespace mungedb.aggregate.pipeline.expressions
	 * @module mungedb-aggregate
	 * @constructor
	 **/
	var klass = function DayOfYearExpression(){
		if(arguments.length !== 0) throw new Error("zero args expected");
		base.call(this);
	}, base = require("./NaryExpression"), proto = klass.prototype = Object.create(base.prototype, {constructor:{value:klass}});

	// PROTOTYPE MEMBERS
	proto.getOpName = function getOpName(){
		return "$dayOfYear";
	};

	proto.addOperand = function addOperand(expr) {
		this.checkArgLimit(1);
		base.prototype.addOperand.call(this, expr);
	};

	/**
	 * Takes a date and returns the day of the year as a number between 1 and 366.
	 * @method evaluate
	 **/
	proto.evaluate = function evaluate(doc){
		//NOTE: the below silliness is to deal with the leap year scenario when we should be returning 366
		this.checkArgCount(1);
		var date = this.operands[0].evaluate(doc);
		return klass.getDateDayOfYear(date);
	};

	// STATIC METHODS
	klass.getDateDayOfYear = function getDateDayOfYear(d){
		var y11 = new Date(d.getUTCFullYear(), 0, 1),	// same year, first month, first day; time omitted
			ymd = new Date(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()+1);	// same y,m,d; time omitted, add 1 because days start at 1
		return Math.ceil((ymd - y11) / 86400000);	//NOTE: 86400000 ms is 1 day
	};

	return klass;
})();