¿Son los nombres de método "más" y "menos" apropiados?

Java SE 8 viene con un nuevo mecanismo de fechas, la introducción LocalDate, LocalTimey LocalDateTimeclases para representar instantes de tiempo. Para manipular esos instantes, se dan una serie de métodos: LocalDate.plusDays(...), LocalDate.minusDays(...)y así sucesivamente.

Siempre he pensado que una buena práctica era nombrar métodos después de los verbos que describen su propósito, ya que los métodos son, en realidad, operaciones a ejecutar, algo que realizará una acción. Solo por mencionar, si se tiene en cuenta las clases como StringBuilder, por ejemplo, los nombres de los métodos son append, insert, delete...

Es por eso que para mí no suena bien nombrar un método en plusDayslugar de sumDays, en minusDayslugar de subtractDays. ¿Solo a mí me resulta muy molesto? ¿Qué piensas?

La única razón por la que puedo pensar es que las fechas son objetos inmutables, por lo que al llamar plusDaysno agrega días al objeto original, sino que crea uno nuevo con nuevas propiedades, pero eso es muy sutil.

La única razón por la que puedo pensar es que las fechas son objetos inmutables, por lo que al llamar a plusDays no agrega días al objeto original, sino que crea uno nuevo con nuevas propiedades, pero eso es muy sutil.

Esta es exactamente la razón. Imagine que tiene algún tipo de API para manipular rangos de fechas con fines de programación. Podría exponer métodos que le permitan hacer una declaración como:

var workdaySchedule = initialSchedule.withoutWeekends();

Esto se lee de manera muy similar a la declaración en inglés: "El horario de trabajo es el horario inicial sin fines de semana". No implica cambiar el horario inicial, implica que el horario de trabajo es algo nuevo y diferente.

Ahora, en cambio, imagine que se llamaba:

var workdaySchedule = initialSchedule.removeWeekends();

Esto es confuso. ¿Se modifica el horario inicial? Ciertamente suena así, porque parece que estamos eliminando los fines de semana. Pero entonces, ¿por qué lo estamos asignando a una nueva variable? Aunque estos dos esquemas de nomenclatura son muy similares, este es mucho menos claramente evocador de lo que está sucediendo. Esto sería más apropiado si removeWeekends lo hizo cambiar la programación inicial, y regresó invalidaría en cuyo caso withoutWeekendssería la opción confuso.

Esto es esencialmente una distinción declarativa versus imperativa. ¿Estamos declarando que workdaySchedulees una cosa particular, o estamos llevando a cabo una lista de instrucciones imperativas (como "eliminar") para hacer esa cosa en particular? Por lo general, la denominación imperativa tiene más sentido cuando está mutando valores, y la declarativa tiene más sentido con valores inmutables, como lo demuestra el ejemplo anterior.

En tu caso, tienes exactamente lo mismo. Si viera:, tomorrow.plusDaysno me imagino que tomorrowestá siendo mutado, mientras que tomorrow.addDays, creo que podría ser. Esto es algo sutil, pero no necesariamente de mala manera. Sin tener que pensarlo demasiado, este nombre naturalmente establece su pensamiento en la línea correcta en términos de si está o no mutando. Para aclarar esta distinción entre estos estilos imperativos y declarativos: "agregar" (y "eliminar") son verbos , mientras que "más" (y "sin") son preposiciones .

En .NET el nombre es diferente, aunque el resultado es exactamente el mismo. En lugar de:

tomorrow = LocalDateTime.plusDays(1);

Ahi esta:

tomorrow = DateTime.Now.AddDays(1);

Esto solo significa que las diferencias entre la comprensión de "más" y "sumar" terminaron como una cuestión de opinión personal. Anímate, no estás solo, al menos puedes elegir el idioma que más te guste:)

Este es probablemente un artefacto del uso de Java .Methodpara todos los métodos, tanto los que modifican el objeto como los que no.

Imagine un lenguaje que también tiene una object=>methodsintaxis, que le daría methoduna copia del objeto para trabajar. Ahora en ese lenguaje, startDate=>plusDays(5)es claramente inequívoco. Toma la fecha original y crea una nueva fecha que es 5 días después.

En una nota sumDaysno relacionada, no tiene sentido aquí. LocalDatees un punto de tiempo , no una duración de tiempo . Puede sumar cualquier cantidad de duraciones (y el resultado es otra duración), y puede agregar un punto de tiempo y una duración (el resultado es otro punto de tiempo), pero no puede sumar puntos de tiempo.