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

"use strict";

/**
 * A $week pipeline expression.
 * @see evaluateInternal
 * @class WeekExpression
 * @namespace mungedb-aggregate.pipeline.expressions
 * @module mungedb-aggregate
 * @constructor
 **/
var WeekExpression = module.exports = function WeekExpression() {
	//this.nargs = 1;
	//base.call(this);
}, klass = WeekExpression, base = require("./FixedArityExpressionT")(klass, 1), proto = klass.prototype = Object.create(base.prototype, {constructor: {value: klass}});

// DEPENDENCIES
var Value = require("../Value"),
	DayOfYearExpression = require("./DayOfYearExpression"),
	Expression = require("./Expression");

// STATIC MEMBERS
klass.extract = function extract(date) {
	//note: copied from evaluateInternal
	dayOfWeek = date.getUTCDay(),
	dayOfYear = DayOfYearExpression.getDateDayOfYear(date),
	prevSundayDayOfYear = dayOfYear - dayOfWeek, // may be negative
	nextSundayDayOfYear = prevSundayDayOfYear + 7; // must be positive
	// Return the zero based index of the week of the next sunday, equal to the one based index of the week of the previous sunday, which is to be returned.

	return (nextSundayDayOfYear / 7) | 0; // also, the `| 0` here truncates this so that we return an integer
};

klass.opName = "$week";

// PROTOTYPE MEMBERS
proto.getOpName = function getOpName() {
	return klass.opName;
};

/**
 * Takes a date and returns the week of the year as a number between 0 and 53.
 * Weeks begin on Sundays, and week 1 begins with the first Sunday of the year.
 * Days preceding the first Sunday of the year are in week 0.
 * This behavior is the same as the “%U” operator to the strftime standard library function.
 * @method evaluateInternal
 **/
proto.evaluateInternal = function evaluateInternal(vars) {
	var date = this.operands[0].evaluateInternal(vars);

	//NOTE: DEVIATION FROM MONGO: need to return a Value object.  Our Value class only consists of static helpers at the moment.  We need a value instance to be consistent.
	return klass.extract(date);
};

/** Register Expression */
Expression.registerExpression(klass.opName, base.parse(klass));